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 控件。parent 和wFlags 将作为参数传递给QGraphicsItem 的构造函数。

[virtual noexcept] QGraphicsProxyWidget::~QGraphicsProxyWidget()

销毁代理控件及其中的所有嵌入式控件。

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

重写：QGraphicsItem::contextMenuEvent(QGraphicsSceneContextMenuEvent *event)。

QGraphicsProxyWidget *QGraphicsProxyWidget::createProxyForChildWidget(QWidget *child)

为该代理中包含的小部件的指定child 创建一个代理小部件。

此函数使得获取非顶级控件的代理成为可能。例如，您可以嵌入一个对话框，然后仅对其中的某个控件进行转换。

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

另请参阅 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)

为该代理中所包含的小部件的指定child 创建一个代理小部件。

请勿直接调用此函数；请改用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 嵌入到此代理控件中。被嵌入的控件必须完全位于Graphics View内部或外部。如果该控件同时在UI的其他位置可见，则无法将其嵌入。

widget 必须是顶级控件，且其父控件为nullptr 。

当控件被嵌入时，其状态（例如：可见性、启用状态、几何形状、尺寸提示）会被复制到代理控件中。如果被嵌入的控件被显式隐藏或禁用，则在嵌入完成后，代理控件也将被显式隐藏或禁用。类文档中提供了关于共享状态的完整概述。

QGraphicsProxyWidget的窗口标志决定了小部件在嵌入后是否会显示窗口装饰。

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

如果调用此函数时某个控件已被该代理嵌入，则该控件将首先被自动解除嵌入。将 `nullptr ` 作为 `widget ` 参数传递时，仅会解除该控件的嵌入，且当前已嵌入控件的所有权将转移给调用方。所有已嵌入的子控件也将被解除嵌入，其代理控件将被销毁。

请注意，设置了Qt::WA_PaintOnScreen 控件属性的控件，以及封装了外部应用程序或控制器的控件，均无法被嵌入。例如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

返回指向嵌入式控件的指针。

另请参阅 setWidget()。