- Qt

Choisissez d'abord la catégorieensuite la rubrique :

Viadeo Twitter Google Bookmarks ! Facebook Digg MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Toutes les fonctions  ·  Vues d'ensemble  · 

QGraphicsProxyWidget Class Reference
[QtGui module]

The QGraphicsProxyWidget class provides a proxy layer for embedding a QWidget in a QGraphicsScene. More...

 #include <QGraphicsProxyWidget>

Inherits QGraphicsWidget.

This class was introduced in Qt 4.4.

Public Functions

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

Reimplemented Public Functions

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

Reimplemented Protected Functions

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

Protected Slots

QGraphicsProxyWidget * newProxyWidget ( const QWidget * child )

Additional Inherited Members

Detailed Description

The QGraphicsProxyWidget class provides a proxy layer for embedding a QWidget in a QGraphicsScene.

QGraphicsProxyWidget embeds QWidget-based widgets, for example, a QPushButton, QFontComboBox, or even QFileDialog, into QGraphicsScene. It forwards events between the two objects and translates between QWidget's integer-based geometry and QGraphicsWidget's qreal-based geometry. QGraphicsProxyWidget supports all core features of QWidget, including tab focus, keyboard input, Drag & Drop, and popups. You can also embed complex widgets, e.g., widgets with subwidgets.


 int main(int argc, char **argv)
     QApplication app(argc, argv);

     QTabWidget *tabWidget = new QTabWidget;

     QGraphicsScene scene;
     QGraphicsProxyWidget *proxy = scene.addWidget(tabWidget);

     QGraphicsView view(&scene);;

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

Embedding a Widget with QGraphicsProxyWidget

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

 QGraphicsScene scene;
 QGraphicsProxyWidget *proxy = scene.addWidget(groupBox);

 QGraphicsView view(&scene);;

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() to embed a 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.

Synchronizing Widget States

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->isVisible();  // returns false
 proxy->isVisible(); // also returns false

QGraphicsProxyWidget maintains symmetry for the following states:

QWidget stateQGraphicsProxyWidget stateNotes
QWidget::visibleQGraphicsProxyWidget::visibleThe explicit state is also symmetric.
QWidget::geometryQGraphicsProxyWidget::geometryGeometry is only guaranteed to be symmetric while the embedded widget is visible.
QWidget::cursorQGraphicsProxyWidget::cursorThe 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::windowTitleQGraphicsProxyWidget::windowTitleUpdated once by setWidget().

Note: 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.

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

See also QGraphicsScene::addWidget() and QGraphicsWidget.

Member Function Documentation

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

Constructs a new QGraphicsProxy widget. parent and wFlags are passed to QGraphicsItem's constructor.

QGraphicsProxyWidget::~QGraphicsProxyWidget ()

Destroys the proxy widget and any embedded widget.

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

Reimplemented from QGraphicsItem::contextMenuEvent().

QGraphicsProxyWidget * QGraphicsProxyWidget::createProxyForChildWidget ( QWidget * child )

Creates a proxy widget for the given child of the widget contained in this proxy.

This function makes it possible to aquire 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.

This function was introduced in Qt 4.5.

See also newProxyWidget() and QGraphicsScene::addWidget().

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

Reimplemented from QGraphicsItem::dragEnterEvent().

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

Reimplemented from QGraphicsItem::dragLeaveEvent().

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

Reimplemented from QGraphicsItem::dragMoveEvent().

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

Reimplemented from QGraphicsItem::dropEvent().

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

Reimplemented from QObject::event().

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

Reimplemented from QObject::eventFilter().

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

Reimplemented from QGraphicsItem::focusInEvent().

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

Reimplemented from QGraphicsWidget::focusNextPrevChild().

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

Reimplemented from QGraphicsItem::focusOutEvent().

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

Reimplemented from QGraphicsWidget::grabMouseEvent().

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

Reimplemented from QGraphicsWidget::hideEvent().

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

Reimplemented from QGraphicsItem::hoverEnterEvent().

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

Reimplemented from QGraphicsItem::hoverLeaveEvent().

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

Reimplemented from QGraphicsItem::hoverMoveEvent().

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

Reimplemented from QGraphicsItem::itemChange().

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

Reimplemented from QGraphicsItem::keyPressEvent().

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

Reimplemented from QGraphicsItem::keyReleaseEvent().

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

Reimplemented from QGraphicsItem::mouseDoubleClickEvent().

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

Reimplemented from QGraphicsItem::mouseMoveEvent().

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

Reimplemented from QGraphicsItem::mousePressEvent().

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

Reimplemented from QGraphicsItem::mouseReleaseEvent().

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

Creates a proxy widget for the given child of the widget contained in this proxy.

You should not call this function directly; use QGraphicsProxyWidget::createProxyForChildWidget() instead.

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.

This function was introduced in Qt 4.5.

See also createProxyForChildWidget().

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

Reimplemented from QGraphicsItem::paint().

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

Reimplemented from QGraphicsWidget::resizeEvent().

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

Reimplemented from QGraphicsLayoutItem::setGeometry().

void QGraphicsProxyWidget::setWidget ( QWidget * widget )

Embeds widget into this proxy widget. The embedded widget must reside exclusively either inside or outside of Graphics View. You cannot embed a widget as long as it is is visible elsewhere in the UI, at the same time.

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

When the widget is embedded, its state (e.g., visible, enabled, geometry, size hints) is copied into the proxy widget. If the embedded widget is explicitly hidden or disabled, the proxy widget will become explicitly hidden or disabled after embedding is complete. The class documentation has a full overview over the shared state.

QGraphicsProxyWidget's window flags determine whether the widget, after embedding, will be given window decorations or not.

After this function returns, QGraphicsProxyWidget will keep its state synchronized with that of widget whenever possible.

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 argument will only unembed the widget, and the ownership of the currently embedded widget will be passed on to the caller. Every child widget that are embedded will also be embedded and their proxy widget destroyed.

Note that widgets with the Qt::WA_PaintOnScreen widget attribute set and widgets that wrap an external application or controller cannot be embedded. Examples are QGLWidget and QAxWidget.

See also widget().

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

Reimplemented from QGraphicsWidget::showEvent().

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

Reimplemented from QGraphicsLayoutItem::sizeHint().

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

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

If no widget is embedded, widget is 0, or widget is not a descendant of the embedded widget, this function returns an empty QRectF.

See also widget().

int QGraphicsProxyWidget::type () const   [virtual]

Reimplemented from QGraphicsItem::type().

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

Reimplemented from QGraphicsWidget::ungrabMouseEvent().

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

Reimplemented from QGraphicsItem::wheelEvent().

QWidget * QGraphicsProxyWidget::widget () const

Returns a pointer to the embedded widget.

See also setWidget().


Best Of

Actualités les plus lues

  1. Microsoft ouvre aux autres compilateurs C++ AMP, la spécification pour la conception d'applications parallèles C++ utilisant le GPU 22
  2. Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
  3. RIM : « 13 % des développeurs ont gagné plus de 100 000 $ sur l'AppWord », Qt et open-source au menu du BlackBerry DevCon Europe 0
  4. BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
  5. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 10
  6. Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
  7. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
Page suivante

Le Qt Labs au hasard


La folie est de mettre en forme le même texte

Les Qt Labs sont les laboratoires des développeurs de Qt, où ils peuvent partager des impressions sur le framework, son utilisation, ce que pourrait être son futur. Lire l'article.



Liens utiles


  • Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).

Qt dans le magazine

Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 4.6
Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !

Hébergement Web

Responsable bénévole de la rubrique Qt : Thibaut Cuvelier -