QHoverEvent Class
La classe QHoverEvent contient des paramètres qui décrivent un événement de souris. En savoir plus...
| En-tête : | #include <QHoverEvent> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake : | QT += gui |
| Hérite de : | QSinglePointEvent |
- Liste de tous les membres, y compris les membres hérités
- Membres obsolètes
- 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 |
Fonctions protégées
| QHoverEvent(QHoverEvent &&) | |
| QHoverEvent & | operator=(QHoverEvent &&) |
| QHoverEvent & | operator=(const QHoverEvent &other) |
Description détaillée
Les événements de souris se produisent lorsque le curseur de la souris entre dans un widget, en sort ou se déplace à l'intérieur de celui-ci, et si le widget possède l'attribut Qt::WA_Hover.
La fonction ` position()` renvoie la position actuelle du curseur, tandis que ` oldPos()` renvoie l'ancienne position de la souris.
Il existe quelques similitudes entre les événements QEvent::HoverEnter et QEvent::HoverLeave, d'une part, et les événements QEvent::Enter et QEvent::Leave, d'autre part. Cependant, ils diffèrent légèrement car nous appelons la fonction update() 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 une fenêtre enfant B qui, à son tour, contient une fenêtre enfant C (toutes avec le suivi de la souris activé) :
À présent, si vous déplacez le curseur du haut vers le bas au milieu de 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 jusqu'au niveau supérieur, qu'il soit accepté ou non. La propagation ne s'arrêtera 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())
Crée un objet d'événement « hover » provenant de device.
Le paramètre type doit prendre l’une des valeurs suivantes : QEvent::HoverEnter, QEvent::HoverLeave ou QEvent::HoverMove.
scenePos correspond à la position actuelle du curseur de la souris par rapport à la fenêtre ou à la scène réceptrice, oldPos correspond à sa position précédente par rapport à celle-ci, et globalPos correspond à la position de la souris en coordonnées absolues. modifiers contient l'état de tous les modificateurs du clavier au moment de l'événement.
[protected delete] QHoverEvent::QHoverEvent(QHoverEvent &&)
Crée par « move » une instance de ` QHoverEvent`. Cette fonction est supprimée.
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, la fonction `oldPos()` renverra la même position que la fonction ` position()`.
Lors d’événements « QEvent::HoverEnter », cette position sera toujours QPoint(-1, -1).
Voir également 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, la fonction `oldPosF()` renverra la même position que la fonction ` position()`.
Lors d’événements « QEvent::HoverEnter », cette position sera toujours QPointF(-1, -1).
Voir également position().
[protected delete] QHoverEvent &QHoverEvent::operator=(QHoverEvent &&)
Cette opération attribue « other » à cette instance « QHoverEvent ». Cette fonction est supprimée.
[noexcept protected default] QHoverEvent &QHoverEvent::operator=(const QHoverEvent &other)
Attribue par copie other à cette instance QHoverEvent.
© 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.
