简述

图形视图对将任何 widget 嵌入到场景中提供了无缝的支持。可以嵌入简单的 widget，例如：QLineEdit、QPushButton；也可以是复杂的 widget，例如：QTabWidget，甚至是完整的主窗口。

要将 widget 嵌入场景中，只需要简单地调用 QGraphicsScene::addWidget()，或者创建一个 QGraphicsProxyWidget 对象并将 widget 手工地嵌入其中。

QGraphicsProxyWidget

QGraphicsProxyWidget 类提供了一个代理层，用于在 QGraphicsScene 中嵌入一个 QWidget。

QGraphicsProxyWidget 嵌入基于 QWidget 的部件，例如：QPushButton、QFontComboBox，甚至 QFileDialog、QGraphicsScene。它在两个对象之间转发事件，并在 QWidget 的基于整数的 geometry 和 QGraphicsWidget 的基于 qreal 的 geometry 之间进行转换。

QGraphicsProxyWidget 支持 QWidget 的所有核心功能，包括：Tab 焦点、键盘输入、拖放和弹出窗口。还可以嵌入复杂的 widget，例如：带有子 widget 的 widget。

QGraphicsProxyWidget 通过为每个 popup 创建一个子代理，来负责嵌入 widget 的 popup 孩子的自动嵌入。这意味着当嵌入的 QComboBox 显示其弹出列表时，会自动创建一个新的 QGraphicsProxyWidget，嵌入 popup 并正确定位。这只有当 popup 是嵌入的 widget 的孩子时才有效（例如： QToolButton::setMenu() 要求 QMenu 实例是 QToolButton 的孩子）。

使用 QGraphicsProxyWidget 嵌入 Widget

使用 QGraphicsProxyWidget 嵌入一个 widget 有两种方法：

• 将一个 widget 指针和任何相关的 Qt::WindowFlags 传递给 QGraphicsScene::addWidget() - 最常用的方式。
• 创建一个新的 QGraphicsProxyWidget，然后调用 setWidget() 嵌入一个 QWidget。

例如，在下面的代码段中，我们在代理中嵌入了一个 QGroupBox：

QGroupBox *pGroupBox = new QGroupBox();
QLabel *pTellLabel = new QLabel();
QLabel *pAddressLabel = new QLabel();
QLineEdit *pTellLineEdit = new QLineEdit();
QLineEdit *pAddressLineEdit = new QLineEdit();

pGroupBox->setTitle(QStringLiteral("联系方式"));
pTellLabel->setText(QStringLiteral("电话号码："));
pAddressLabel->setText(QStringLiteral("居住地址："));
pTellLineEdit->setPlaceholderText(QStringLiteral("手机/固话"));
pAddressLineEdit->setPlaceholderText(QStringLiteral("具体到门牌号"));

QFormLayout *pLayout = new QFormLayout;
pLayout->addRow(pTellLabel, pTellLineEdit);
pLayout->addRow(pAddressLabel, pAddressLineEdit);
pLayout->setSpacing(10);
pLayout->setMargin(20);
pGroupBox->setLayout(pLayout);

QGraphicsScene scene;
QGraphicsProxyWidget *pProxy = scene.addWidget(pGroupBox);

QGraphicsView view(&scene);
view.show();

QGraphicsProxyWidget 与 QWidget 共享所有权，因此，如果这两个 widget 中的任一个被销毁，另一个也将被自动销毁。

同步 Widget 状态

QGraphicsProxyWidget 保持其与嵌入的 widget 状态同步。例如，如果代理被隐藏或禁用，嵌入的 widget 也将被隐藏或禁用，反之亦然。

当 widget 通过调用 addWidget() 被嵌入时，QGraphicsProxyWidget 将 widget 的状态（例如：visible、enabled、geometry、size hints）复制到代理中，然后，两者将尽可能地保持同步。 默认情况下，当一个 widget 被嵌入到代理中后，widget 和代理都是可见的，因为 QGraphicsWidget 在创建时是可见的（不必调用 show()）。如果显式隐藏嵌入的 widget ，代理也将变为不可见。

示例：

QGraphicsScene scene;

QLineEdit *edit = new QLineEdit;
QGraphicsProxyWidget *proxy = scene.addWidget(edit);

edit->isVisible();  // 返回 true
proxy->isVisible(); // 也返回 true

edit->hide();

edit->isVisible();  // 返回 false
proxy->isVisible(); // 也返回 false

QGraphicsProxyWidget 保持以下状态的对称性：

注意：当 widget 被嵌入时，QGraphicsScene 保持嵌入的 widget 在一个特殊的状态，防止它影响其他 widget（嵌入和非嵌入）。在此状态下，widget 在行为上可能与未嵌入时略有不同。

警告： QGraphicsProxyWidget 类是为了便于桥接 QWidgets 和 QGraphicsItems 而提供，不应该用于高性能场景。