内容

• 公共函数
• 重实现公共函数
• 重实现保护函数
• 保护槽
• 详细描述
• 采用 QGraphicsProxyWidget 嵌入 Widget
• 同步 Widget 状态

QGraphicsProxyWidget 类

QGraphicsProxyWidget class provides a proxy layer for embedding a QWidget 在 QGraphicsScene . 更多...

头：	#include <QGraphicsProxyWidget>
qmake:	QT += widgets
Since:	Qt 4.4
继承：	QGraphicsWidget

• 所有成员列表，包括继承成员

公共函数

	QGraphicsProxyWidget (QGraphicsItem * parent = Q_NULLPTR, Qt::WindowFlags wFlags = Qt::WindowFlags())
	~QGraphicsProxyWidget ()
QGraphicsProxyWidget *	createProxyForChildWidget (QWidget * child )
void	setWidget (QWidget * widget )
QRectF	subWidgetRect (const QWidget * widget ) const
QWidget *	widget () const

重实现公共函数

virtual void	paint (QPainter * painter , const QStyleOptionGraphicsItem * option , QWidget * widget )
virtual void	setGeometry (const QRectF & rect )
virtual int	type () const

• 53 公共函数继承自 QGraphicsWidget
• 2 公共函数继承自 QGraphicsObject
• 35 公共函数继承自 QGraphicsLayoutItem
• 32 公共函数继承自 QObject
• 176 公共函数继承自 QGraphicsItem

重实现保护函数

virtual void	contextMenuEvent (QGraphicsSceneContextMenuEvent * event )
virtual void	dragEnterEvent (QGraphicsSceneDragDropEvent * event )
virtual void	dragLeaveEvent (QGraphicsSceneDragDropEvent * event )
virtual void	dragMoveEvent (QGraphicsSceneDragDropEvent * event )
virtual void	dropEvent (QGraphicsSceneDragDropEvent * event )
virtual bool	event (QEvent * event )
virtual bool	eventFilter (QObject * object , QEvent * event )
virtual void	focusInEvent (QFocusEvent * event )
virtual bool	focusNextPrevChild (bool next )
virtual void	focusOutEvent (QFocusEvent * event )
virtual void	grabMouseEvent (QEvent * event )
virtual void	hideEvent (QHideEvent * event )
virtual void	hoverEnterEvent (QGraphicsSceneHoverEvent * event )
virtual void	hoverLeaveEvent (QGraphicsSceneHoverEvent * event )
virtual void	hoverMoveEvent (QGraphicsSceneHoverEvent * event )
virtual void	inputMethodEvent (QInputMethodEvent * event )
virtual QVariant	inputMethodQuery (Qt::InputMethodQuery query ) const
virtual QVariant	itemChange (GraphicsItemChange change , const QVariant & value )
virtual void	keyPressEvent (QKeyEvent * event )
virtual void	keyReleaseEvent (QKeyEvent * event )
virtual void	mouseDoubleClickEvent (QGraphicsSceneMouseEvent * event )
virtual void	mouseMoveEvent (QGraphicsSceneMouseEvent * event )
virtual void	mousePressEvent (QGraphicsSceneMouseEvent * event )
virtual void	mouseReleaseEvent (QGraphicsSceneMouseEvent * event )
virtual void	resizeEvent (QGraphicsSceneResizeEvent * event )
virtual void	showEvent (QShowEvent * event )
virtual QSizeF	sizeHint (Qt::SizeHint which , const QSizeF & constraint = QSizeF()) const
virtual void	ungrabMouseEvent (QEvent * event )
virtual void	wheelEvent (QGraphicsSceneWheelEvent * event )

• 24 保护函数继承自 QGraphicsWidget
• 1 保护函数继承自 QGraphicsObject
• 3 保护函数继承自 QGraphicsLayoutItem
• 9 保护函数继承自 QObject
• 24 保护函数继承自 QGraphicsItem

保护槽

QGraphicsProxyWidget *

newProxyWidget (const QWidget * child )

• 1 保护槽继承自 QGraphicsObject

额外继承成员

• 14 特性继承自 QGraphicsWidget
• 12 特性继承自 QGraphicsObject
• 1 特性继承自 QObject
• 1 公共槽继承自 QGraphicsWidget
• 1 公共槽继承自 QObject
• 1 信号继承自 QGraphicsWidget
• 9 信号继承自 QGraphicsObject
• 2 信号继承自 QObject
• 1 静态公共成员继承自 QGraphicsWidget
• 11 静态公共成员继承自 QObject
• 2 static public members inherited from QGraphicsItem
• 24 保护函数继承自 QGraphicsWidget
• 1 保护函数继承自 QGraphicsObject
• 3 保护函数继承自 QGraphicsLayoutItem
• 9 保护函数继承自 QObject
• 24 保护函数继承自 QGraphicsItem

详细描述

QGraphicsProxyWidget class provides a proxy layer for embedding a QWidget 在 QGraphicsScene .

QGraphicsProxyWidget embeds QWidget 基小部件，例如 QPushButton , QFontComboBox ，或者甚至 QFileDialog ，进 QGraphicsScene 。它在 2 对象之间转发事件及翻译介于 QWidget 基于整数的几何图形和 QGraphicsWidget 's qreal-based geometry. QGraphicsProxyWidget supports all core features of QWidget ，包括 Tab 焦点、键盘输入、拖放及弹出窗口。还可以嵌入复杂 Widget，如：带子小部件的小部件。

范例：

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 takes care of automatically embedding popup children of embedded widgets through creating a child proxy for each popup. This means that when an embedded QComboBox shows its popup list, a new QGraphicsProxyWidget is created automatically, embedding the popup, and positioning it correctly. This only works if the popup is child of the embedded widget (for example QToolButton::setMenu () requires the QMenu instance to be child of the QToolButton ).

采用 QGraphicsProxyWidget 嵌入 Widget

There are two ways to embed a widget using QGraphicsProxyWidget . The most common way is to pass a widget pointer to QGraphicsScene::addWidget () together with any relevant Qt::WindowFlags . This function returns a pointer to a QGraphicsProxyWidget . You can then choose to reparent or position either the proxy, or the embedded widget itself.

For example, in the code snippet below, we embed a group box into the proxy:

QGroupBox *groupBox = new QGroupBox("Contact Details");
QLabel *numberLabel = new QLabel("Telephone number");
QLineEdit *numberEdit = new QLineEdit;
QFormLayout *layout = new QFormLayout;
layout->addRow(numberLabel, numberEdit);
groupBox->setLayout(layout);
QGraphicsScene scene;
QGraphicsProxyWidget *proxy = scene.addWidget(groupBox);
QGraphicsView view(&scene);
view.show();
					

The image below is the output obtained with its contents margin and contents rect labeled.

Alternatively, you can start by creating a new QGraphicsProxyWidget item, and then call setWidget () 以嵌入 QWidget later. The widget () function returns a pointer to the embedded widget. QGraphicsProxyWidget shares ownership with QWidget , so if either of the two widgets are destroyed, the other widget will be automatically destroyed as well.

同步 Widget 状态

QGraphicsProxyWidget keeps its state in sync with the embedded widget. For example, if the proxy is hidden or disabled, the embedded widget will be hidden or disabled as well, and vice versa. When the widget is embedded by calling addWidget(), QGraphicsProxyWidget copies the state from the widget into the proxy, and after that, the two will stay synchronized where possible. By default, when you embed a widget into a proxy, both the widget and the proxy will be visible because a QGraphicsWidget is visible when created (you do not have to call show ()). If you explicitly hide the embedded widget, the proxy will also become invisible.

范例：

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 maintains symmetry for the following states:

QWidget state	QGraphicsProxyWidget state	注意事项
QWidget::enabled	QGraphicsProxyWidget::enabled
QWidget::visible	QGraphicsProxyWidget::visible	The explicit state is also symmetric.
QWidget::geometry	QGraphicsProxyWidget::geometry	Geometry is only guaranteed to be symmetric while the embedded widget is visible.
QWidget::layoutDirection	QGraphicsProxyWidget::layoutDirection
QWidget::style	QGraphicsProxyWidget::style
QWidget::palette	QGraphicsProxyWidget::palette
QWidget::font	QGraphicsProxyWidget::font
QWidget::cursor	QGraphicsProxyWidget::cursor	The embedded widget overrides the proxy widget cursor. The proxy cursor changes depending on which embedded subwidget is currently under the mouse.
QWidget::sizeHint ()	QGraphicsProxyWidget::sizeHint ()	All size hint functionality from the embedded widget is forwarded by the proxy.
QWidget::getContentsMargins ()	QGraphicsProxyWidget::getContentsMargins ()	Updated once by setWidget ().
QWidget::windowTitle	QGraphicsProxyWidget::windowTitle	Updated once by setWidget ().

注意： QGraphicsScene keeps the embedded widget in a special state that prevents it from disturbing other widgets (both embedded and not embedded) while the widget is embedded. In this state, the widget may differ slightly in behavior from when it is not embedded.

警告： This class is provided for convenience when bridging QWidgets and QGraphicsItems, it should not be used for high-performance scenarios.

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

成员函数文档编制

QGraphicsProxyWidget:: QGraphicsProxyWidget ( QGraphicsItem * parent = Q_NULLPTR, Qt::WindowFlags wFlags = Qt::WindowFlags())

构造新的 QGraphicsProxy 小部件。 parent and wFlags 被传递给 QGraphicsItem 的构造函数。

QGraphicsProxyWidget:: ~QGraphicsProxyWidget ()

销毁代理 Widget 和任何嵌入 Widget。

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

重实现自 QGraphicsItem::contextMenuEvent ().

QGraphicsProxyWidget *QGraphicsProxyWidget:: createProxyForChildWidget ( QWidget * child )

创建代理 Widget 为给定 child of the widget contained in this proxy.

This function makes it possible to acquire proxies for non top-level widgets. For instance, you can embed a dialog, and then transform only one of its widgets.

If the widget is already embedded, return the existing proxy widget.

该函数在 Qt 4.5 引入。

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

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

重实现自 QGraphicsItem::dragEnterEvent ().

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

重实现自 QGraphicsItem::dragLeaveEvent ().

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

重实现自 QGraphicsItem::dragMoveEvent ().

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

重实现自 QGraphicsItem::dropEvent ().

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

重实现自 QObject::event ().

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

重实现自 QObject::eventFilter ().

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

重实现自 QGraphicsItem::focusInEvent ().

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

重实现自 QGraphicsWidget::focusNextPrevChild ().

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

重实现自 QGraphicsItem::focusOutEvent ().

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

重实现自 QGraphicsWidget::grabMouseEvent ().

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

重实现自 QGraphicsWidget::hideEvent ().

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

重实现自 QGraphicsItem::hoverEnterEvent ().

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

重实现自 QGraphicsItem::hoverLeaveEvent ().

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

重实现自 QGraphicsItem::hoverMoveEvent ().

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

重实现自 QGraphicsItem::inputMethodEvent ().

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

重实现自 QGraphicsItem::inputMethodQuery ().

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

重实现自 QGraphicsItem::itemChange ().

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

重实现自 QGraphicsItem::keyPressEvent ().

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

重实现自 QGraphicsItem::keyReleaseEvent ().

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

重实现自 QGraphicsItem::mouseDoubleClickEvent ().

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

重实现自 QGraphicsItem::mouseMoveEvent ().

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

重实现自 QGraphicsItem::mousePressEvent ().

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

重实现自 QGraphicsItem::mouseReleaseEvent ().

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

创建代理 Widget 为给定 child of the widget contained in this proxy.

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

This function is a fake virtual slot that you can reimplement in your subclass in order to control how new proxy widgets are created. The default implementation returns a proxy created with the QGraphicsProxyWidget () constructor with this proxy widget as the parent.

该函数在 Qt 4.5 引入。

另请参阅 createProxyForChildWidget ().

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

重实现自 QGraphicsItem::paint ().

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

重实现自 QGraphicsWidget::resizeEvent ().

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

重实现自 QGraphicsLayoutItem::setGeometry ().

void QGraphicsProxyWidget:: setWidget ( QWidget * widget )

嵌入 widget 到此代理 Widget。嵌入 Widget 必须独占位于图形视图内部 (或外部)。Widget 就无法嵌入，只要在 UI 的其它地方同时可见。

widget must be a top-level widget whose parent is 0.

当 Widget 嵌入时，其状态 (如：可见、启用、几何体、尺寸提示) 会被拷贝到代理小部件。若嵌入小部件被明确隐藏或禁用，代理 Widget 将在嵌入完成后变为被明确隐藏或禁用。类文档编制对共享状态有完整概述。

QGraphicsProxyWidget 的窗口标志确定 Widget 在嵌入后，是否赋予其窗口装饰。

此函数返回后， QGraphicsProxyWidget 将同步保持其状态同 widget 每当可能时。

If a widget is already embedded by this proxy when this function is called, that widget will first be automatically unembedded. Passing 0 for the widget 自变量仅取消嵌入 Widget，且目前嵌入 Widget 的所有权会被传递给调用者。每个嵌入子级 Widget 也被嵌入，且它们的代理 Widget 会被销毁。

注意：Widget 具有 Qt::WA_PaintOnScreen widget attribute set and widgets that wrap an external application or controller cannot be embedded. Examples are QGLWidget and QAxWidget .

另请参阅 widget ().

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

重实现自 QGraphicsWidget::showEvent ().

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

重实现自 QGraphicsLayoutItem::sizeHint ().

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

Returns the rectangle for widget , which must be a descendant of widget ()，或 widget () itself, in this proxy item's local coordinates.

若没有嵌入小部件， widget is 0, or widget is not a descendant of the embedded widget, this function returns an empty QRectF .

另请参阅 widget ().

[virtual] int QGraphicsProxyWidget:: type () const

重实现自 QGraphicsItem::type ().

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

重实现自 QGraphicsWidget::ungrabMouseEvent ().

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

重实现自 QGraphicsItem::wheelEvent ().

QWidget *QGraphicsProxyWidget:: widget () const

返回嵌入 Widget 指针。

另请参阅 setWidget ().