message WM_MOUSEHOVER

Publié dans une fenêtre lorsque le curseur pointe sur la zone cliente de la fenêtre pendant la période spécifiée dans un appel antérieur à TrackMouseEvent.

Une fenêtre reçoit ce message via sa fonction WindowProc.

C++

#define WM_MOUSEHOVER                   0x02A1

Paramètres

wParam

Indique si différentes clés virtuelles sont en panne. Ce paramètre peut être une ou plusieurs des valeurs suivantes.

Valeur	Signification
MK_CONTROL 0x0008	La touche Ctrl est enfoncée.
MK_LBUTTON 0x0001	Le bouton gauche de la souris est enfoncé.
MK_MBUTTON 0x0010	Le bouton central de la souris est enfoncé.
MK_RBUTTON 0x0002	Le bouton droit de la souris est enfoncé.
MK_SHIFT 0x0004	La touche Maj est enfoncée.
MK_XBUTTON1 0x0020	La XBUTTON1 est en panne.
MK_XBUTTON2 0x0040	La XBUTTON2 est en panne.

lParam

Le mot de bas ordre spécifie la coordonnée x du curseur. La coordonnée est relative au coin supérieur gauche de la zone cliente.

Le mot à ordre élevé spécifie la coordonnée y du curseur. La coordonnée est relative au coin supérieur gauche de la zone cliente.

Valeur de retour

Si une application traite ce message, elle doit retourner zéro.

Remarques

Le suivi de pointage s’arrête lorsque WM_MOUSEHOVER est généré. L’application doit appeler TrackMouseEvent à nouveau si elle nécessite un suivi supplémentaire du comportement du pointage de la souris.

Utilisez le code suivant pour obtenir la position horizontale et verticale :

xPos = GET_X_LPARAM(lParam); 
yPos = GET_Y_LPARAM(lParam); 

Comme indiqué ci-dessus, la coordonnée x se trouve dans le court de la valeur de retour ; la coordonnée y se trouve dans l’ordre élevé courte (les deux représentent valeurs signées, car elles peuvent prendre des valeurs négatives sur les systèmes avec plusieurs moniteurs). Si la valeur de retour est affectée à une variable, vous pouvez utiliser la macro MAKEPOINTS pour obtenir une structure POINTS à partir de la valeur de retour. Vous pouvez également utiliser la macro GET_X_LPARAM ou GET_Y_LPARAM pour extraire la coordonnée x ou y.

Important

N’utilisez pas les LOWORD ou macros HIWORD pour extraire les coordonnées x et y de la position du curseur, car ces macros retournent des résultats incorrects sur les systèmes avec plusieurs moniteurs. Les systèmes avec plusieurs moniteurs peuvent avoir des coordonnées x et y négatives, et LOWORD et HIWORD traiter les coordonnées comme des quantités non signées.

Exigences

Exigence	Valeur
Client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	Winuser.h (inclure Windowsx.h)

Voir aussi

de référence

GET_X_LPARAM

GET_Y_LPARAM

GetCapture

setCapture

TrackMouseEvent

TRACKMOUSEEVENT

conceptuelle

d’entrée de la souris

autres ressources

MAKEPOINTS

POINTS