QHoverEvent

La classe QHoverEvent contient des paramètres qui décrivent un événement lié à la souris. Plus d'informations...

#include <QHoverEvent>

Héritage

Hérite de QEvent.

Description détaillée

La classe QHoverEvent contient des paramètres qui décrivent un événement lié à la souris.

Les événements liés à la souris se produisent quand le curseur entre, sort ou bouge à l'intérieur d'un widget et si le widget a l'attribut Qt::WA_Hover.

La fonction pos() donne la position actuelle du curseur, tandis que oldPos() donne son ancienne position.

Il y quelques similarités 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 parce qu'un update() est réalisé dans les gestionnaires événementiels de HoverEnter et HoverLeave.

QEvent::HoverMove est également légèrement différent de QEvent::MouseMove. Considérons une fenêtre de haut niveau A contenant un enfant B qui lui même contient un enfant C (tout avec le suivi de la souris activé) :

Maintenant, si vous déplacez le curseur du haut vers le bas au milieu de A, vous obtiendrez les événements QEvent::MouseMove suivants :

1. A::MouseMove ;
2. B::MouseMove ;
3. C::MouseMove.

Vous obtiendrez les mêmes événements avec QEvent::HoverMove, à la différence que l'événement se propage toujours vers le widget de haut niveau sans tenir compte du fait que l'événement ait été accepté ou pas. La propagation s'arrêtera uniquement avec l'attribut Qt::WA_NoMousePropagation.

Dans ce cas les événements vont se produire de la façon suivante :

1. A::HoverMove ;
2. A::HoverMove, B::HoverMove ;
3. A::HoverMove, B::HoverMove, C::HoverMove.

Fonctions membres

QHoverEvent::QHoverEvent ( Type type, const QPoint & pos, const QPoint & oldPos )

Construit un événement de survol.

La paramètre type doit être QEvent::HoverEnter, QEvent::HoverLeave ou QEvent::HoverMove.

Le paramètre pos est la position actuelle du curseur, relative au widget recevant, tandis que oldPos est la position précédente du curseur, relative au widget recevant.

const QPoint & QHoverEvent::oldPos () const

Retourne la position précédente du curseur, relative au widget qui a reçu l'évènement. S'il n'y a pas de position précédente, oldPos() retournera la même position que pos().

Pour des événements QEvent::HoverEnter, cette position sera toujours QPoint(-1, -1).

Voir aussi pos().

const QPoint & QHoverEvent::pos () const

Retourne la position actuelle du curseur, relative au widget qui a reçu l'événement.

Pour des événements QEvent::HoverLeave, cette position sera toujours QPoint(-1, -1).

Voir aussi oldPos().

Remerciements

Merci à Nicolas Carion pour la traduction ainsi qu'à Jonathan Courtois et Maxime Gault pour la relecture !