QGraphicsProxyWidget 类

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

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

[虚拟 noexcept] QGraphicsProxyWidget::~QGraphicsProxyWidget()

销毁代理小部件以及任何嵌入的小部件。

[重写 虚保护] void QGraphicsProxyWidget::contextMenuEvent(QGraphicsSceneContextMenuEvent *event)

重写: QGraphicsItem::contextMenuEvent(QGraphicsSceneContextMenuEvent *event).

QGraphicsProxyWidget *QGraphicsProxyWidget::createProxyForChildWidget(QWidget *child)

为存储在此代理中的小部件的给定 子 创建代理小部件。

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

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

另请参阅newProxyWidget() 和 QGraphicsScene::addWidget().

[重写 虚保护] void QGraphicsProxyWidget::dragEnterEvent(QGraphicsSceneDragDropEvent *event)

重写: QGraphicsItem::dragEnterEvent(QGraphicsSceneDragDropEvent *event).

[重写 虚保护] void QGraphicsProxyWidget::dragLeaveEvent(QGraphicsSceneDragDropEvent *event)

重写: QGraphicsItem::dragLeaveEvent(QGraphicsSceneDragDropEvent *event).

[重写 虚保护] void QGraphicsProxyWidget::dragMoveEvent(QGraphicsSceneDragDropEvent *event)

重写: QGraphicsItem::dragMoveEvent(QGraphicsSceneDragDropEvent *event).

[重写 虚保护] void QGraphicsProxyWidget::dropEvent(QGraphicsSceneDragDropEvent *event)

重写: QGraphicsItem::dropEvent(QGraphicsSceneDragDropEvent *event).

[重写 虚保护] bool QGraphicsProxyWidget::event(QEvent *event)

重写: QGraphicsWidget::event(QEvent *event).

[重写 虚保护] bool QGraphicsProxyWidget::eventFilter(QObject *object, QEvent *event)

重写: QObject::eventFilter(QObject *watched, QEvent *event).

[重写 虚保护] void QGraphicsProxyWidget::focusInEvent(QFocusEvent *event)

重写: QGraphicsWidget::focusInEvent(QFocusEvent *event).

[重写 虚保护] bool QGraphicsProxyWidget::focusNextPrevChild(bool next)

重写: QGraphicsWidget::focusNextPrevChild(bool next).

[重写虚受保护] void QGraphicsProxyWidget::focusOutEvent(QFocusEvent *event)

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

[重写虚受保护] void QGraphicsProxyWidget::grabMouseEvent(QEvent *event)

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

[重写虚受保护] void QGraphicsProxyWidget::hideEvent(QHideEvent *event)

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

[重写虚受保护] void QGraphicsProxyWidget::hoverEnterEvent(QGraphicsSceneHoverEvent *event)

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

[重写虚受保护] void QGraphicsProxyWidget::hoverLeaveEvent(QGraphicsSceneHoverEvent *event)

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

[重写虚受保护] void QGraphicsProxyWidget::hoverMoveEvent(QGraphicsSceneHoverEvent *event)

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

[重写虚受保护] QVariant QGraphicsProxyWidget::inputMethodEvent(QInputMethodEvent *event)

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

[重写虚受保护] QVariant QGraphicsProxyWidget::inputMethodQuery(Qt::InputMethodQuery query) const

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

[重写虚受保护] QVariant QGraphicsProxyWidget::itemChange(QGraphicsItem::GraphicsItemChange change, const QVariant &value)

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

[重写虚受保护] void QGraphicsProxyWidget::keyPressEvent(QKeyEvent *event)

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

[重写虚受保护] void QGraphicsProxyWidget::keyReleaseEvent(QKeyEvent *event)

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

[重写虚拟受保护] void QGraphicsProxyWidget::mouseDoubleClickEvent(QGraphicsSceneMouseEvent *event)

重写：QGraphicsItem::mouseDoubleClickEvent(QGraphicsSceneMouseEvent *event).

[重写虚拟受保护] void QGraphicsProxyWidget::mouseMoveEvent(QGraphicsSceneMouseEvent *event)

重写：QGraphicsItem::mouseMoveEvent(QGraphicsSceneMouseEvent *event).

[重写虚拟受保护] void QGraphicsProxyWidget::mousePressEvent(QGraphicsSceneMouseEvent *event)

重写：QGraphicsItem::mousePressEvent(QGraphicsSceneMouseEvent *event).

[重写虚拟受保护] void QGraphicsProxyWidget::mouseReleaseEvent(QGraphicsSceneMouseEvent *event)

重写：QGraphicsItem::mouseReleaseEvent(QGraphicsSceneMouseEvent *event).

[受保护槽函数] QGraphicsProxyWidget *QGraphicsProxyWidget::newProxyWidget(const QWidget *child)

为存储在此代理中的小部件的给定 子 创建代理小部件。

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

此函数是一个假虚槽，您可以在子类中重写它以控制如何创建新的代理小部件。默认实现使用包含此代理小部件作为父级的 QGraphicsProxyWidget() 构造函数创建代理。

另请参阅createProxyForChildWidget。

[重写虚拟] void QGraphicsProxyWidget::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)

重写：QGraphicsWidget::paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget).

[重写虚拟受保护] void QGraphicsProxyWidget::resizeEvent(QGraphicsSceneResizeEvent *event)

重写：QGraphicsWidget::resizeEvent(QGraphicsSceneResizeEvent *event).

[重写虚拟] void QGraphicsProxyWidget::setGeometry(const QRectF &rect)

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

void QGraphicsProxyWidget::setWidget(QWidget *widget)

将 widget 嵌入此代理小部件中。嵌入的小部件必须驻留在图形视图内部或外部。只要它在 UI 中的其他位置可见，您就不能嵌入小部件。

部件必须是一个顶层部件，且其父级是nullptr。

当部件嵌入时，其状态（例如，可见性、启用状态、几何形状、尺寸提示）将被复制到代理部件中。如果嵌入的部件被明确隐藏或禁用，代理部件在嵌入完成后也将被明确隐藏或禁用。类文档对该共享状态有一个全面的概述。

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

此函数返回后，QGraphicsProxyWidget将尽可能地保持其状态与部件同步。

如果在这个函数被调用之前，此代理已经嵌入了一个部件，那么这个部件将会首先自动卸载。传递widget参数为nullptr只会卸载该部件，并将当前嵌入部件的拥有权传递给调用者。所有嵌入的子部件也会被嵌入，并销毁其代理部件。

注意，设置了Qt::WA_PaintOnScreen部件属性和包装了外部应用程序或控制器的部件无法嵌入。例如，QOpenGLWidget和QAxWidget。

另请参阅widget()。

[重写虚保护] void QGraphicsProxyWidget::showEvent(QShowEvent *event)

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

[重写虚保护] 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是nullptr，或者widget不是嵌入部件的子代，则此函数返回一个空的QRectF。

另请参阅widget()。

[重写虚] int QGraphicsProxyWidget::type() const

重新实现：QGraphicsWidget::type() const。

[重写虚保护] void QGraphicsProxyWidget::ungrabMouseEvent(QEvent *event)

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

[重写虚保护] void QGraphicsProxyWidget::wheelEvent(QGraphicsSceneWheelEvent *event)

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

QWidget *QGraphicsProxyWidget::widget() const

返回嵌入小部件的指针。

另请参阅 setWidget().