QHoverEvent Class
La classe QHoverEvent contient des paramètres qui décrivent un événement souris. Plus d'informations...
| En-tête : | #include <QHoverEvent> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui)target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
| Héritages : | QSinglePointEvent |
- Liste de tous les membres, y compris les membres hérités
- Membres dépréciés
- QHoverEvent fait partie des classes d'événements.
Fonctions publiques
| QHoverEvent(QEvent::Type type, const QPointF &scenePos, const QPointF &globalPos, const QPointF &oldPos, Qt::KeyboardModifiers modifiers = Qt::NoModifier, const QPointingDevice *device = QPointingDevice::primaryPointingDevice()) | |
| QPoint | oldPos() const |
| QPointF | oldPosF() const |
Description détaillée
Les événements souris se produisent lorsque le curseur de la souris est déplacé dans, hors ou à l'intérieur d'un widget, et si le widget possède l'attribut Qt::WA_Hover.
La fonction position() indique la position actuelle du curseur, tandis que oldPos() indique l'ancienne position de la souris.
Il existe quelques similitudes entre les événements QEvent::HoverEnter et QEvent::HoverLeave, et les événements QEvent::Enter et QEvent::Leave. Cependant, ils sont légèrement différents car nous effectuons une mise à jour () dans le gestionnaire d'événements de HoverEnter et HoverLeave.
QEvent::HoverMove est également légèrement différent de QEvent::MouseMove. Considérons une fenêtre de niveau supérieur A contenant un enfant B qui contient à son tour un enfant C (le suivi de la souris étant activé) :
Si vous déplacez le curseur du haut vers le bas au milieu de la fenêtre A, vous obtiendrez les événements QEvent::MouseMove suivants :
- A::MouseMove
- B::MouseMove
- C::MouseMove
Vous obtiendrez les mêmes événements pour QEvent::HoverMove, sauf que l'événement se propage toujours au niveau supérieur, qu'il soit accepté ou non. Il ne cessera de se propager qu'avec l'attribut Qt::WA_NoMousePropagation.
Dans ce cas, les événements se produiront de la manière suivante :
- A::HoverMove
- A::HoverMove, B::HoverMove
- A::HoverMove, B::HoverMove, C::HoverMove
Documentation des fonctions membres
QHoverEvent::QHoverEvent(QEvent::Type type, const QPointF &scenePos, const QPointF &globalPos, const QPointF &oldPos, Qt::KeyboardModifiers modifiers = Qt::NoModifier, const QPointingDevice *device = QPointingDevice::primaryPointingDevice())
Construit un objet d'événement de survol provenant de device.
Le paramètre type doit être QEvent::HoverEnter, QEvent::HoverLeave ou QEvent::HoverMove.
Le paramètre scenePos est la position actuelle du curseur de la souris par rapport à la fenêtre ou à la scène réceptrice, oldPos est sa position précédente, et globalPos est la position de la souris en coordonnées absolues. modifiers contient l'état de tous les modificateurs de clavier au moment de l'événement.
QPoint QHoverEvent::oldPos() const
Renvoie la position précédente du curseur de la souris, par rapport au widget qui a reçu l'événement. S'il n'y a pas de position précédente, oldPos() renvoie la même position que position().
Pour les événements QEvent::HoverEnter, cette position sera toujours QPoint(-1, -1).
Voir aussi position().
QPointF QHoverEvent::oldPosF() const
Renvoie la position précédente du curseur de la souris, par rapport au widget qui a reçu l'événement. S'il n'y a pas de position précédente, oldPosF() renvoie la même position que position().
Pour les événements QEvent::HoverEnter, cette position sera toujours QPointF(-1, -1).
Voir aussi position().
© 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.
