Sur cette page

QGraphicsSceneEvent Class

La classe `QGraphicsSceneEvent` sert de classe de base à tous les événements liés aux vues graphiques. En savoir plus...

En-tête : #include <QGraphicsSceneEvent>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Hérite de : QEvent
Hérité par :

QGraphicsSceneContextMenuEvent, QGraphicsSceneDragDropEvent, QGraphicsSceneHelpEvent, QGraphicsSceneHoverEvent, QGraphicsSceneMouseEvent, QGraphicsSceneMoveEvent, QGraphicsSceneResizeEvent, et QGraphicsSceneWheelEvent

Fonctions publiques

virtual ~QGraphicsSceneEvent()
(since 6.2) quint64 timestamp() const
QWidget *widget() const

Description détaillée

Lorsqu’un QGraphicsView reçoit des événements Qt liés à la souris, au clavier et au glisser-déposer (QMouseEvent, QKeyEvent, QDragEvent, etc.), il les convertit en instances de sous-classes de QGraphicsSceneEvent et les transmet à l’ QGraphicsScene qu’il affiche. La scène transmet ensuite les événements aux éléments concernés.

Par exemple, lorsqu’une « QGraphicsView » reçoit un « QMouseEvent » de type « MousePress » en réponse à un clic de l’utilisateur, la vue envoie un « QGraphicsSceneMouseEvent » de type « GraphicsSceneMousePress » à la « QGraphicsScene » sous-jacente via 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() ».

Des sous-classes telles que QGraphicsSceneMouseEvent et QGraphicsSceneContextMenuEvent fournissent les coordonnées issues de l’ QEvent d’origine sous forme de coordonnées d’écran, de scène et d’élément (voir screenPos(), scenePos() et pos()). Les coordonnées de l'élément sont définies par l'QGraphicsScene avant qu'il ne transmette l'événement à un QGraphicsItem. Les événements de souris offrent é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 également QEvent.

Documentation des fonctions membres

[virtual noexcept] QGraphicsSceneEvent::~QGraphicsSceneEvent()

Supprime l'événement.

[since 6.2] quint64 QGraphicsSceneEvent::timestamp() const

Renvoie l'horodatage de l'événement d'origine, ou 0 si celui-ci ne comporte pas d'horodatage.

Cette fonction a été introduite dans Qt 6.2.

QWidget *QGraphicsSceneEvent::widget() const

Renvoie le widget à l'origine de l'événement, ou ` nullptr ` si l'événement provient d'une autre application.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.