QGraphicsProxyWidget Class
La clase `QGraphicsProxyWidget` proporciona una capa proxy para incrustar un ` QWidget ` en un ` QGraphicsScene`. Más información...
| Encabezado: | #include <QGraphicsProxyWidget> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Heredan: | QGraphicsWidget |
Tipos públicos
| enum { Type } |
Funciones públicas
| QGraphicsProxyWidget(QGraphicsItem *parent = nullptr, Qt::WindowFlags wFlags = Qt::WindowFlags()) | |
| virtual | ~QGraphicsProxyWidget() |
| QGraphicsProxyWidget * | createProxyForChildWidget(QWidget *child) |
| void | setWidget(QWidget *widget) |
| QRectF | subWidgetRect(const QWidget *widget) const |
| QWidget * | widget() const |
Funciones públicas reimplementadas
| virtual void | paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget) override |
| virtual void | setGeometry(const QRectF &rect) override |
| virtual int | type() const override |
Funciones protegidas reimplementadas
| virtual void | contextMenuEvent(QGraphicsSceneContextMenuEvent *event) override |
| virtual void | dragEnterEvent(QGraphicsSceneDragDropEvent *event) override |
| virtual void | dragLeaveEvent(QGraphicsSceneDragDropEvent *event) override |
| virtual void | dragMoveEvent(QGraphicsSceneDragDropEvent *event) override |
| virtual void | dropEvent(QGraphicsSceneDragDropEvent *event) override |
| virtual bool | event(QEvent *event) override |
| virtual bool | eventFilter(QObject *object, QEvent *event) override |
| virtual void | focusInEvent(QFocusEvent *event) override |
| virtual bool | focusNextPrevChild(bool next) override |
| virtual void | focusOutEvent(QFocusEvent *event) override |
| virtual void | grabMouseEvent(QEvent *event) override |
| virtual void | hideEvent(QHideEvent *event) override |
| virtual void | hoverEnterEvent(QGraphicsSceneHoverEvent *event) override |
| virtual void | hoverLeaveEvent(QGraphicsSceneHoverEvent *event) override |
| virtual void | hoverMoveEvent(QGraphicsSceneHoverEvent *event) override |
| virtual void | inputMethodEvent(QInputMethodEvent *event) override |
| virtual QVariant | inputMethodQuery(Qt::InputMethodQuery query) const override |
| virtual QVariant | itemChange(QGraphicsItem::GraphicsItemChange change, const QVariant &value) override |
| virtual void | keyPressEvent(QKeyEvent *event) override |
| virtual void | keyReleaseEvent(QKeyEvent *event) override |
| virtual void | mouseDoubleClickEvent(QGraphicsSceneMouseEvent *event) override |
| virtual void | mouseMoveEvent(QGraphicsSceneMouseEvent *event) override |
| virtual void | mousePressEvent(QGraphicsSceneMouseEvent *event) override |
| virtual void | mouseReleaseEvent(QGraphicsSceneMouseEvent *event) override |
| virtual void | resizeEvent(QGraphicsSceneResizeEvent *event) override |
| virtual void | showEvent(QShowEvent *event) override |
| virtual QSizeF | sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const override |
| virtual void | ungrabMouseEvent(QEvent *event) override |
| virtual void | wheelEvent(QGraphicsSceneWheelEvent *event) override |
Ranuras protegidas
| QGraphicsProxyWidget * | newProxyWidget(const QWidget *child) |
Descripción detallada
QGraphicsProxyWidget integra widgets basados en ` QWidget` —por ejemplo, un ` QPushButton`, ` QFontComboBox` o incluso ` QFileDialog`— en ` QGraphicsScene`. Reenvía eventos entre los dos objetos y realiza la conversión entre la geometría basada en enteros de ` QWidget` y la geometría basada en `qreal` de ` QGraphicsWidget`. QGraphicsProxyWidget es compatible con todas las características principales de QWidget, incluyendo el foco de pestaña, la entrada por teclado, la función «arrastrar y soltar» y las ventanas emergentes. También permite incrustar widgets complejos, por ejemplo, widgets con subwidgets.
Ejemplo:
int main(int argc, char **argv)
{
QApplication app(argc, argv);
QTabWidget *tabWidget = new QTabWidget;
QGraphicsScene scene;
QGraphicsProxyWidget *proxy = scene.addWidget(tabWidget);
QGraphicsView view(&scene);
view.show();
return app.exec();
}QGraphicsProxyWidget se encarga de incrustar automáticamente las ventanas emergentes que son hijos de los widgets incrustados mediante la creación de un proxy hijo para cada ventana emergente. Esto significa que, cuando un QComboBox incrustado muestra su lista emergente, se crea automáticamente un nuevo QGraphicsProxyWidget que incrusta la ventana emergente y la coloca correctamente. Esto solo funciona si el menú emergente es un elemento secundario del widget incrustado (por ejemplo, ` QToolButton::setMenu()` requiere que la instancia ` QMenu ` sea un elemento secundario de ` QToolButton`).
Incrustación de un widget con QGraphicsProxyWidget
Hay dos formas de incrustar un widget utilizando `QGraphicsProxyWidget`. La forma más habitual es pasar un puntero al widget a ` QGraphicsScene::addWidget()` junto con cualquier ` Qt::WindowFlags` relevante. Esta función devuelve un puntero a un `QGraphicsProxyWidget`. A continuación, puedes elegir cambiar la relación de parentesco o la posición, ya sea del proxy o del propio widget incrustado.
Por ejemplo, en el fragmento de código siguiente, incrustamos un cuadro de grupo en el proxy:
QGroupBox *groupBox = new QGroupBox("Contact Details");
QLabel *numberLabel = new QLabel("Telephone number");
QLineEdit *numberEdit = new QLineEdit;
QFormLayout *layout = new QFormLayout(groupBox);
layout->addRow(numberLabel, numberEdit);
QGraphicsScene scene;
QGraphicsProxyWidget *proxy = scene.addWidget(groupBox);
QGraphicsView view(&scene);
view.show();La imagen siguiente muestra el resultado obtenido con el margen del contenido y el rectángulo del contenido etiquetados.

Como alternativa, puedes empezar creando un nuevo elemento QGraphicsProxyWidget y, a continuación, llamar a setWidget() para incrustar un QWidget más tarde. La función widget() devuelve un puntero al widget incrustado. QGraphicsProxyWidget comparte la propiedad con QWidget, por lo que si se destruye cualquiera de los dos widgets, el otro también se destruirá automáticamente.
Sincronización de los estados de los widgets
QGraphicsProxyWidget mantiene su estado sincronizado con el del widget incrustado. Por ejemplo, si el proxy está oculto o desactivado, el widget incrustado también lo estará, y viceversa. Cuando el widget se incrusta llamando a `addWidget()`, `QGraphicsProxyWidget` copia el estado del widget al proxy y, a partir de ese momento, ambos permanecerán sincronizados siempre que sea posible. Por defecto, al incrustar un widget en un proxy, tanto el widget como el proxy serán visibles, ya que un ` QGraphicsWidget ` es visible al crearse (no es necesario llamar a ` show()`). Si se oculta explícitamente el widget incrustado, el proxy también se volverá invisible.
Ejemplo:
QGraphicsScene scene;
QLineEdit *edit = new QLineEdit;
QGraphicsProxyWidget *proxy = scene.addWidget(edit);
edit->isVisible(); // returns true
proxy->isVisible(); // also returns true
edit->hide();
edit->isVisible(); // returns false
proxy->isVisible(); // also returns falseQGraphicsProxyWidget mantiene la simetría en los siguientes estados:
| QWidget estado | Estado de QGraphicsProxyWidget | Notas |
|---|---|---|
| QWidget::enabled | QGraphicsProxyWidget::enabled | |
| QWidget::visible | QGraphicsProxyWidget::visible | El estado explícito también es simétrico. |
| QWidget::geometry | QGraphicsProxyWidget::geometry | Solo se garantiza que la geometría sea simétrica mientras el widget incrustado esté visible. |
| QWidget::layoutDirection | QGraphicsProxyWidget::layoutDirection | |
| QWidget::style | QGraphicsProxyWidget::style | |
| QWidget::palette | QGraphicsProxyWidget::paleta | |
| QWidget::font | QGraphicsProxyWidget::font | |
| QWidget::cursor | QGraphicsProxyWidget::cursor | El widget incrustado anula el cursor del widget proxy. El cursor del proxy cambia en función del subwidget incrustado que se encuentre en ese momento bajo el puntero del ratón. |
| QWidget::sizeHint() | QGraphicsProxyWidget::sizeHint() | El proxy reenvía toda la funcionalidad de sugerencias de tamaño del widget incrustado. |
| QWidget::getContentsMargins() | QGraphicsProxyWidget::getContentsMargins() | Se actualiza una vez mediante ` setWidget()`. |
| QWidget::windowTitle | QGraphicsProxyWidget::windowTitle | Actualizado una vez por setWidget(). |
Nota: QGraphicsScene mantiene el widget incrustado en un estado especial que evita que interfiera con otros widgets (tanto incrustados como no incrustados) mientras está incrustado. En este estado, el comportamiento del widget puede diferir ligeramente del que tiene cuando no está incrustado.
Advertencia: Esta clase se proporciona para facilitar la conexión entre QWidgets y QGraphicsItems; no debe utilizarse en escenarios que requieran un alto rendimiento. En concreto, la incrustación de widgets en una escena que luego se muestra a través de un QGraphicsView que utiliza una ventana de visualización OpenGL no funcionará en todas las combinaciones.
Véase también QGraphicsScene::addWidget() y QGraphicsWidget.
Documentación sobre tipos de miembros
[anonymous] enum
El valor devuelto por la función virtual ` type()`.
| Constante | Valor | Descripción |
|---|---|---|
QGraphicsProxyWidget::Type | 12 | Un widget proxy de gráficos |
Documentación de las funciones de miembro
QGraphicsProxyWidget::QGraphicsProxyWidget(QGraphicsItem *parent = nullptr, Qt::WindowFlags wFlags = Qt::WindowFlags())
Crea un nuevo widget QGraphicsProxy. Se pasan los parámetros « parent » y « wFlags » al constructor de « QGraphicsItem ».
[virtual noexcept] QGraphicsProxyWidget::~QGraphicsProxyWidget()
Elimina el widget proxy y cualquier widget incrustado.
[override virtual protected] void QGraphicsProxyWidget::contextMenuEvent(QGraphicsSceneContextMenuEvent *event)
Reimplementa: ` QGraphicsItem::contextMenuEvent(QGraphicsSceneContextMenuEvent *event)`.
QGraphicsProxyWidget *QGraphicsProxyWidget::createProxyForChildWidget(QWidget *child)
Crea un widget proxy para el child especificado del widget contenido en este proxy.
Esta función permite obtener proxies para widgets que no son de nivel superior. Por ejemplo, puedes incrustar un cuadro de diálogo y, a continuación, transformar solo uno de sus widgets.
Si el widget ya está incrustado, devuelve el widget proxy existente.
Véase también newProxyWidget() y QGraphicsScene::addWidget().
[override virtual protected] void QGraphicsProxyWidget::dragEnterEvent(QGraphicsSceneDragDropEvent *event)
Reimplementa: QGraphicsItem::dragEnterEvent(QGraphicsSceneDragDropEvent *event).
[override virtual protected] void QGraphicsProxyWidget::dragLeaveEvent(QGraphicsSceneDragDropEvent *event)
Reimplementa: QGraphicsItem::dragLeaveEvent(QGraphicsSceneDragDropEvent *event).
[override virtual protected] void QGraphicsProxyWidget::dragMoveEvent(QGraphicsSceneDragDropEvent *event)
Reimplementa: QGraphicsItem::dragMoveEvent(QGraphicsSceneDragDropEvent *event).
[override virtual protected] void QGraphicsProxyWidget::dropEvent(QGraphicsSceneDragDropEvent *event)
Reimplementa: QGraphicsItem::dropEvent(QGraphicsSceneDragDropEvent *event).
[override virtual protected] bool QGraphicsProxyWidget::event(QEvent *event)
Reimplementa: ` QGraphicsWidget::event(QEvent *event)`.
[override virtual protected] bool QGraphicsProxyWidget::eventFilter(QObject *object, QEvent *event)
Reimplementa: QObject::eventFilter(QObject *watched, QEvent *event).
[override virtual protected] void QGraphicsProxyWidget::focusInEvent(QFocusEvent *event)
Reimplementa: QGraphicsWidget::focusInEvent(QFocusEvent *event).
[override virtual protected] bool QGraphicsProxyWidget::focusNextPrevChild(bool next)
Reimplementa: ` QGraphicsWidget::focusNextPrevChild` (bool next).
[override virtual protected] void QGraphicsProxyWidget::focusOutEvent(QFocusEvent *event)
Reimplementa: QGraphicsWidget::focusOutEvent(QFocusEvent *event).
[override virtual protected] void QGraphicsProxyWidget::grabMouseEvent(QEvent *event)
Reimplementa: ` QGraphicsWidget::grabMouseEvent(QEvent *event)`.
[override virtual protected] void QGraphicsProxyWidget::hideEvent(QHideEvent *event)
Reimplementa: QGraphicsWidget::hideEvent(QHideEvent *event).
[override virtual protected] void QGraphicsProxyWidget::hoverEnterEvent(QGraphicsSceneHoverEvent *event)
Reimplementa: ` QGraphicsItem::hoverEnterEvent(QGraphicsSceneHoverEvent *event)`.
[override virtual protected] void QGraphicsProxyWidget::hoverLeaveEvent(QGraphicsSceneHoverEvent *event)
Reimplementa: QGraphicsWidget::hoverLeaveEvent(QGraphicsSceneHoverEvent *event).
[override virtual protected] void QGraphicsProxyWidget::hoverMoveEvent(QGraphicsSceneHoverEvent *event)
Reimplementa: QGraphicsWidget::hoverMoveEvent(QGraphicsSceneHoverEvent *event).
[override virtual protected] void QGraphicsProxyWidget::inputMethodEvent(QInputMethodEvent *event)
Reimplementa: ` QGraphicsItem::inputMethodEvent(QInputMethodEvent *event)`.
[override virtual protected] QVariant QGraphicsProxyWidget::inputMethodQuery(Qt::InputMethodQuery query) const
Reimplementa: ` QGraphicsItem::inputMethodQuery` (conste `Qt::InputMethodQuery query`).
[override virtual protected] QVariant QGraphicsProxyWidget::itemChange(QGraphicsItem::GraphicsItemChange change, const QVariant &value)
Reimplementa: QGraphicsWidget::itemChange(QGraphicsItem::GraphicsItemChange change, const QVariant &value).
[override virtual protected] void QGraphicsProxyWidget::keyPressEvent(QKeyEvent *event)
Reimplementa: ` QGraphicsItem::keyPressEvent(QKeyEvent *event)`.
[override virtual protected] void QGraphicsProxyWidget::keyReleaseEvent(QKeyEvent *event)
Reimplementa: ` QGraphicsItem::keyReleaseEvent(QKeyEvent *event)`.
[override virtual protected] void QGraphicsProxyWidget::mouseDoubleClickEvent(QGraphicsSceneMouseEvent *event)
Reimplementa: ` QGraphicsItem::mouseDoubleClickEvent(QGraphicsSceneMouseEvent *event)`.
[override virtual protected] void QGraphicsProxyWidget::mouseMoveEvent(QGraphicsSceneMouseEvent *event)
Reimplementa: ` QGraphicsItem::mouseMoveEvent(QGraphicsSceneMouseEvent *event)`.
[override virtual protected] void QGraphicsProxyWidget::mousePressEvent(QGraphicsSceneMouseEvent *event)
Reimplementa: ` QGraphicsItem::mousePressEvent(QGraphicsSceneMouseEvent *event)`.
[override virtual protected] void QGraphicsProxyWidget::mouseReleaseEvent(QGraphicsSceneMouseEvent *event)
Reimplementa: ` QGraphicsItem::mouseReleaseEvent(QGraphicsSceneMouseEvent *event)`.
[protected slot] QGraphicsProxyWidget *QGraphicsProxyWidget::newProxyWidget(const QWidget *child)
Crea un widget proxy para el child especificado del widget contenido en este proxy.
No debes llamar a esta función directamente; utiliza en su lugar QGraphicsProxyWidget::createProxyForChildWidget().
Esta función es una ranura virtual ficticia que puede reimplementar en su subclase para controlar cómo se crean los nuevos widgets proxy. La implementación por defecto devuelve un proxy creado con el constructor QGraphicsProxyWidget() con este widget proxy como padre.
Véase también ` createProxyForChildWidget()`.
[override virtual] void QGraphicsProxyWidget::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)
Reimplementa: ` QGraphicsWidget::paint` (`QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)`.
[override virtual protected] void QGraphicsProxyWidget::resizeEvent(QGraphicsSceneResizeEvent *event)
Reimplementa: ` QGraphicsWidget::resizeEvent(QGraphicsSceneResizeEvent *event)`.
[override virtual] void QGraphicsProxyWidget::setGeometry(const QRectF &rect)
Reimplementa: QGraphicsLayoutItem::setGeometry(const QRectF &rect).
void QGraphicsProxyWidget::setWidget(QWidget *widget)
Incorpora « widget » en este widget proxy. El widget incorporado debe residir exclusivamente dentro o fuera de «Graphics View». No se puede incorporar un widget mientras este sea visible al mismo tiempo en cualquier otro lugar de la interfaz de usuario.
widget Debe ser un widget de nivel superior cuyo padre sea nullptr.
Cuando se incrusta el widget, su estado (por ejemplo, visible, habilitado, geometría, indicaciones de tamaño) se copia en el widget proxy. Si el widget incrustado se oculta o deshabilita explícitamente, el widget proxy quedará oculto o deshabilitado explícitamente una vez completada la incrustación. La documentación de la clase ofrece una descripción completa del estado compartido.
QGraphicsProxyWidgetLos indicadores de ventana determinan si, tras la incrustación, el widget recibirá decoraciones de ventana o no.
Una vez que esta función devuelva un resultado, ` QGraphicsProxyWidget ` mantendrá su estado sincronizado con el de ` widget ` siempre que sea posible.
Si este proxy ya tiene un widget incrustado cuando se llama a esta función, dicho widget se desincrustará automáticamente en primer lugar. Al pasar nullptr como argumento de widget, solo se desincrustará el widget, y la propiedad del widget actualmente incrustado se transferirá al llamante. Todos los widgets hijos que estén incrustados también se desincrustarán y se destruirá su widget proxy.
Ten en cuenta que los widgets con el atributo Qt::WA_PaintOnScreen activado y los widgets que envuelven una aplicación o un controlador externo no se pueden incrustar. Algunos ejemplos son QOpenGLWidget y QAxWidget.
Véase también widget().
[override virtual protected] void QGraphicsProxyWidget::showEvent(QShowEvent *event)
Reimplementa: ` QGraphicsWidget::showEvent(QShowEvent *event)`.
[override virtual protected] QSizeF QGraphicsProxyWidget::sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const
Reimplementa: ` QGraphicsWidget::sizeHint` (`Qt::SizeHint which, const QSizeF &constraint) const`.
QRectF QGraphicsProxyWidget::subWidgetRect(const QWidget *widget) const
Devuelve el rectángulo correspondiente a widget, que debe ser un descendiente de widget() o del propio widget(), en las coordenadas locales de este elemento proxy.
Si no hay ningún widget incrustado, si ` widget ` es ` nullptr` o si ` widget ` no es un descendiente del widget incrustado, esta función devuelve un ` QRectF` vacío.
Véase también widget().
[override virtual] int QGraphicsProxyWidget::type() const
Reimplementa: ` QGraphicsWidget::type()` const.
[override virtual protected] void QGraphicsProxyWidget::ungrabMouseEvent(QEvent *event)
Reimplementa: ` QGraphicsWidget::ungrabMouseEvent(QEvent *event)`.
[override virtual protected] void QGraphicsProxyWidget::wheelEvent(QGraphicsSceneWheelEvent *event)
Reimplementa: ` QGraphicsItem::wheelEvent(QGraphicsSceneWheelEvent *event)`.
QWidget *QGraphicsProxyWidget::widget() const
Devuelve un puntero al widget incrustado.
Véase también ` setWidget()`.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.