===== QHoverEvent ===== 

La classe QHoverEvent contient des paramètres qui décrivent un événement lié à la souris. [[#Description détaillée|Plus d'informations...]]

<!inc!>

==== 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#WidgetAttribute-enum|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#Type-enum|QEvent::HoverEnter]] et [[qevent#Type-enum|QEvent::HoverLeave]], et les événements [[qevent#Type-enum|QEvent::Enter]] et [[qevent#Type-enum|QEvent::Leave]]. Cependant, ils sont légèrement différents parce qu'un update() est réalisé dans les gestionnaires événementiels de [[qevent#Type-enum|HoverEnter]] et [[qevent#Type-enum|HoverLeave]].

[[qevent#Type-enum|QEvent::HoverMove]] est également légèrement différent de [[qevent#Type-enum|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é) :

{{ http://qt.developpez.com/doc/4.6/images/hoverevents.png |}}

Maintenant, si vous déplacez le curseur du haut vers le bas au milieu de A, vous obtiendrez les événements [[qevent#Type-enum|QEvent::MouseMove]] suivants :

  - ''A::MouseMove'' ;
  - ''B::MouseMove'' ;
  - ''C::MouseMove''.

Vous obtiendrez les mêmes événements avec [[qevent#Type-enum|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#WidgetAttribute-enum|Qt::WA_NoMousePropagation]].

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

  - ''A::HoverMove'' ;
  - ''A::HoverMove'', ''B::HoverMove'' ;
  - ''A::HoverMove'', ''B::HoverMove'', ''C::HoverMove''.

==== Fonctions membres ====

=== QHoverEvent() ===

''QHoverEvent::QHoverEvent ( [[qevent#Type-enum|Type]] type, const [[QPoint]] &amp; pos, const [[QPoint]] &amp; oldPos )''

Construit un événement de survol.

La paramètre ''type'' doit être [[qevent#Type-enum|QEvent::HoverEnter]], [[qevent#Type-enum|QEvent::HoverLeave]] ou [[qevent#Type-enum|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.

=== oldPos() ===

''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 [[qhoverevent#pos|pos()]].

Pour des événements [[qevent#Type-enum|QEvent::HoverEnter]], cette position sera toujours [[QPoint]](-1, -1).

Voir aussi [[#pos()]].

=== 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#Type-enum|QEvent::HoverLeave]], cette position sera toujours [[QPoint]](-1, -1).

Voir aussi [[#oldPos()]].

==== Remerciements ====

Merci à <!alcino!> pour la traduction ainsi qu'à <!johnlamericain!> et <!eusebe!> pour la relecture !