En esta página

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.

El widget de proxy y su widget incrustado, con sus respectivas posiciones

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 false

QGraphicsProxyWidget mantiene la simetría en los siguientes estados:

QWidget estadoEstado de QGraphicsProxyWidgetNotas
QWidget::enabledQGraphicsProxyWidget::enabled
QWidget::visibleQGraphicsProxyWidget::visibleEl estado explícito también es simétrico.
QWidget::geometryQGraphicsProxyWidget::geometrySolo se garantiza que la geometría sea simétrica mientras el widget incrustado esté visible.
QWidget::layoutDirectionQGraphicsProxyWidget::layoutDirection
QWidget::styleQGraphicsProxyWidget::style
QWidget::paletteQGraphicsProxyWidget::paleta
QWidget::fontQGraphicsProxyWidget::font
QWidget::cursorQGraphicsProxyWidget::cursorEl 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::windowTitleQGraphicsProxyWidget::windowTitleActualizado 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()`.

ConstanteValorDescripción
QGraphicsProxyWidget::Type12Un 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.