QGraphicsSceneEvent

La classe QGraphicsSceneEvent fournit la classe de base pour tous les événements apparentés aux vues graphiques. Plus d'informations...

#include <QGraphicsSceneEvent>

Voir la position dans l'arbre des classes.

Héritage

Hérite de QEvent.

Hérité par QGraphicsSceneContextMenuEvent, QGraphicsSceneDragDropEvent, QGraphicsSceneHelpEvent, QGraphicsSceneHoverEvent, QGraphicsSceneMouseEvent, QGraphicsSceneMoveEvent, QGraphicsSceneResizeEvent et QGraphicsSceneWheelEvent.

Cette classe a été introduite dans Qt 4.2.

Description détaillée

La classe QGraphicsSceneEvent fournit la classe de base pour tous les événements apparentés aux vues graphiques.

Lorsqu'une QGraphicsView reçoit les événements de souris, de clavier et de glisser-déposer de Qt (QMouseEvent, QKeyEvent, QDragEvent, etc.), elle les transforme en instances de sous-classes de QGraphicsSceneEvent et les redirige à la QGraphicsScene qui les affiche. Ensuite, la scène les transmet aux éléments concernés.

Par exemple, lorsqu'une QGraphicsView reçoit un QMouseEvent de type MousePress comme réponse à un clic de l'utilisateur, la vue émet un QGraphicsSceneMouseEvent de type GraphicsSceneMousePress pour la QGraphicsScene sous-jacente à travers sa fonction mousePressEvent(). L'implémentation par défaut de QGraphicsScene::mousePressEvent() détermine quel élément a été cliqué et transmet l'événement à QGraphicsItem::mousePressEvent().

Les sous-classes telles que QGraphicsSceneMouseEvent et QGraphicsSceneContextMenuEvent fournissent les coordonnées du QEvent original dans les coordonnées de l'écran, de la scène et de l'élément (voir screenPos(), scenePos() et pos()). Les coordonnées de l'élément sont gérées par la QGraphicsScene avant qu'elle ne transmette l'événement à un événement vers un QGraphicsItem. Les événements de la souris ajoutent également la possibilité de récupérer les coordonnées du dernier événement reçu par la vue (voir lastScreenPos(), lastScenePos() et lastPos()).

Voir aussi QEvent.

Fonctions membres

QGraphicsSceneEvent::~QGraphicsSceneEvent ()

Détruit l'objet.

QWidget * QGraphicsSceneEvent::widget () const

Retourne le widget d'où provient l'événement ou 0 si l'événement provient d'une autre application.

Remerciements

Merci à Dimitry Ernot pour la traduction et à Jonathan Courtois ainsi qu'à Jacques Thery pour leur relecture !