QGraphicsProxyWidget Class

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();
}

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();

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::QGraphicsProxyWidget(QGraphicsItem *parent = nullptr, Qt::WindowFlags wFlags = Qt::WindowFlags())

构造一个新的 QGraphicsProxy widget。parent 和wFlags 被传递给QGraphicsItem 的构造函数。

[virtual noexcept] QGraphicsProxyWidget::~QGraphicsProxyWidget()

销毁代理 widget 和任何嵌入式 widget。

[override virtual protected] void QGraphicsProxyWidget::contextMenuEvent(QGraphicsSceneContextMenuEvent *event)

重实现：QGraphicsItem::contextMenuEvent(QGraphicsSceneContextMenuEvent *event).

QGraphicsProxyWidget *QGraphicsProxyWidget::createProxyForChildWidget(QWidget *child)

为该代理中包含的 widget 的给定child 创建一个代理 widget。

通过该函数，可以为非顶级 widget 获取代理。例如，您可以嵌入一个对话框，然后只转换其中一个部件。

如果该部件已嵌入，则返回现有的代理部件。

另请参见 newProxyWidget() 和QGraphicsScene::addWidget()。

[override virtual protected] void QGraphicsProxyWidget::dragEnterEvent(QGraphicsSceneDragDropEvent *event)

重实现：QGraphicsItem::dragEnterEvent(QGraphicsSceneDragDropEvent *event).

[override virtual protected] void QGraphicsProxyWidget::dragLeaveEvent(QGraphicsSceneDragDropEvent *event)

重实现：QGraphicsItem::dragLeaveEvent(QGraphicsSceneDragDropEvent *event).

[override virtual protected] void QGraphicsProxyWidget::dragMoveEvent(QGraphicsSceneDragDropEvent *event)

重实现：QGraphicsItem::dragMoveEvent(QGraphicsSceneDragDropEvent *event).

[override virtual protected] void QGraphicsProxyWidget::dropEvent(QGraphicsSceneDragDropEvent *event)

重实现：QGraphicsItem::dropEvent(QGraphicsSceneDragDropEvent *event).

[override virtual protected] bool QGraphicsProxyWidget::event(QEvent *event)

重实现：QGraphicsWidget::event(QEvent *event).

[override virtual protected] bool QGraphicsProxyWidget::eventFilter(QObject *object, QEvent *event)

重实现：QObject::eventFilter(QObject *watched, QEvent *event).

[override virtual protected] void QGraphicsProxyWidget::focusInEvent(QFocusEvent *event)

重实现：QGraphicsWidget::focusInEvent(QFocusEvent *event).

[override virtual protected] bool QGraphicsProxyWidget::focusNextPrevChild(bool next)

重实现：QGraphicsWidget::focusNextPrevChild(bool next）。

[override virtual protected] void QGraphicsProxyWidget::focusOutEvent(QFocusEvent *event)

重实现：QGraphicsWidget::focusOutEvent(QFocusEvent *event).

[override virtual protected] void QGraphicsProxyWidget::grabMouseEvent(QEvent *event)

重实现：QGraphicsWidget::grabMouseEvent(QEvent *event).

[override virtual protected] void QGraphicsProxyWidget::hideEvent(QHideEvent *event)

重实现：QGraphicsWidget::hideEvent(QHideEvent *event).

[override virtual protected] void QGraphicsProxyWidget::hoverEnterEvent(QGraphicsSceneHoverEvent *event)

重实现：QGraphicsItem::hoverEnterEvent(QGraphicsSceneHoverEvent *event).

[override virtual protected] void QGraphicsProxyWidget::hoverLeaveEvent(QGraphicsSceneHoverEvent *event)

重实现：QGraphicsWidget::hoverLeaveEvent(QGraphicsSceneHoverEvent *event).

[override virtual protected] void QGraphicsProxyWidget::hoverMoveEvent(QGraphicsSceneHoverEvent *event)

重实现：QGraphicsWidget::hoverMoveEvent(QGraphicsSceneHoverEvent *event).

[override virtual protected] void QGraphicsProxyWidget::inputMethodEvent(QInputMethodEvent *event)

重实现：QGraphicsItem::inputMethodEvent(QInputMethodEvent *event).

[override virtual protected] QVariant QGraphicsProxyWidget::inputMethodQuery(Qt::InputMethodQuery query) const

重实现：QGraphicsItem::inputMethodQuery(Qt::InputMethodQuery query) const.

[override virtual protected] QVariant QGraphicsProxyWidget::itemChange(QGraphicsItem::GraphicsItemChange change, const QVariant &value)

重实现：QGraphicsWidget::itemChange(QGraphicsItem::GraphicsItemChange change, const QVariant &value).

[override virtual protected] void QGraphicsProxyWidget::keyPressEvent(QKeyEvent *event)

重实现：QGraphicsItem::keyPressEvent(QKeyEvent *event).

[override virtual protected] void QGraphicsProxyWidget::keyReleaseEvent(QKeyEvent *event)

重实现：QGraphicsItem::keyReleaseEvent(QKeyEvent *event).

[override virtual protected] void QGraphicsProxyWidget::mouseDoubleClickEvent(QGraphicsSceneMouseEvent *event)

重实现：QGraphicsItem::mouseDoubleClickEvent(QGraphicsSceneMouseEvent *event).

[override virtual protected] void QGraphicsProxyWidget::mouseMoveEvent(QGraphicsSceneMouseEvent *event)

重实现：QGraphicsItem::mouseMoveEvent(QGraphicsSceneMouseEvent *event).

[override virtual protected] void QGraphicsProxyWidget::mousePressEvent(QGraphicsSceneMouseEvent *event)

重实现：QGraphicsItem::mousePressEvent(QGraphicsSceneMouseEvent *event).

[override virtual protected] void QGraphicsProxyWidget::mouseReleaseEvent(QGraphicsSceneMouseEvent *event)

重实现：QGraphicsItem::mouseReleaseEvent(QGraphicsSceneMouseEvent *event).

[protected slot] QGraphicsProxyWidget *QGraphicsProxyWidget::newProxyWidget(const QWidget *child)

为该代理中包含的 widget 的给定child 创建一个代理 widget。

请勿直接调用此函数；请使用QGraphicsProxyWidget::createProxyForChildWidget() 代替。

该函数是一个虚假的虚拟槽，您可以在子类中重新实现它，以控制如何创建新的代理部件。默认实现会返回一个使用QGraphicsProxyWidget() 构造函数创建的代理，该代理部件为父部件。

另请参见 createProxyForChildWidget()。

[override virtual] void QGraphicsProxyWidget::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)

重实现：QGraphicsWidget::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)。

[override virtual protected] void QGraphicsProxyWidget::resizeEvent(QGraphicsSceneResizeEvent *event)

重实现：QGraphicsWidget::resizeEvent(QGraphicsSceneResizeEvent *event).

[override virtual] void QGraphicsProxyWidget::setGeometry(const QRectF &rect)

重实现：QGraphicsLayoutItem::setGeometry(const QRectF &rect).

void QGraphicsProxyWidget::setWidget(QWidget *widget)

将widget 嵌入此代理部件。嵌入的 widget 必须完全位于图形视图内部或外部。只要在用户界面的其他地方同时可见，就不能嵌入 Widget。

widget Widget 必须是父级为 的顶级 Widget。nullptr

嵌入部件后，其状态（如可见、启用、几何形状、尺寸提示）会复制到代理部件中。如果嵌入的 widget 显式隐藏或禁用，那么代理 widget 也会在嵌入完成后显式隐藏或禁用。类文档对共享状态有全面的概述。

QGraphicsProxyWidget代理窗口部件的窗口标志决定了嵌入后窗口部件是否会被赋予窗口装饰。

该函数返回后，QGraphicsProxyWidget 将尽可能保持与widget 的状态同步。

如果在调用此函数时，某个部件已被此代理嵌入，该部件将首先被自动解除嵌入。为widget 参数传递nullptr 只会取消嵌入 widget，而当前嵌入 widget 的所有权将传递给调用者。嵌入的每个子部件也将被嵌入，其代理部件也将被销毁。

请注意，设置了Qt::WA_PaintOnScreen widget 属性的 widget 和封装了外部应用程序或控制器的 widget 不能被嵌入。例如QOpenGLWidget 和 QAxWidget。

另请参阅 widget().

[override virtual protected] void QGraphicsProxyWidget::showEvent(QShowEvent *event)

重实现：QGraphicsWidget::showEvent(QShowEvent *event).

[override virtual protected] QSizeF QGraphicsProxyWidget::sizeHint(Qt::SizeHint which, const QSizeF &constraint = QSizeF()) const

重实现：QGraphicsWidget::sizeHint(Qt::SizeHint which, const QSizeF &constraint) const.

QRectF QGraphicsProxyWidget::subWidgetRect(const QWidget *widget) const

返回widget 的矩形，该矩形必须是widget() 的后代，或widget() 本身，以该代理项的本地坐标表示。

如果没有嵌入部件，widget 是nullptr ，或widget 不是嵌入部件的后代，则此函数返回空的QRectF 。

另请参阅 widget()。

[override virtual] int QGraphicsProxyWidget::type() const

重实现：QGraphicsWidget::type() const.

[override virtual protected] void QGraphicsProxyWidget::ungrabMouseEvent(QEvent *event)

重实现：QGraphicsWidget::ungrabMouseEvent(QEvent *event).

[override virtual protected] void QGraphicsProxyWidget::wheelEvent(QGraphicsSceneWheelEvent *event)

重实现：QGraphicsItem::wheelEvent(QGraphicsSceneWheelEvent *event).

QWidget *QGraphicsProxyWidget::widget() const

返回指向嵌入式 widget 的指针。

另请参阅 setWidget()。