Partager via


TrackMouseEvent, fonction (winuser.h)

Publie des messages lorsque le pointeur de la souris quitte une fenêtre ou pointe dessus pendant une durée déterminée.

Note La fonction _TrackMouseEvent appelle TrackMouseEvent s’il existe, sinon _TrackMouseEvent émule TrackMouseEvent.
 

Syntaxe

BOOL TrackMouseEvent(
  [in, out] LPTRACKMOUSEEVENT lpEventTrack
);

Paramètres

[in, out] lpEventTrack

Type : LPTRACKMOUSEEVENT

Pointeur vers une structure TRACKMOUSEEVENT qui contient des informations de suivi.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Le pointeur de la souris est considéré comme pointant lorsqu’il reste dans un rectangle spécifié pendant une période spécifiée. Appelez SystemParametersInfo. et utilisez les valeurs SPI_GETMOUSEHOVERWIDTH, SPI_GETMOUSEHOVERHEIGHT et SPI_GETMOUSEHOVERTIME pour récupérer la taille du rectangle et l’heure.

La fonction peut publier les messages suivants.

Message Description
WM_NCMOUSEHOVER La même signification que WM_MOUSEHOVER sauf pour la zone non cliente de la fenêtre.
WM_NCMOUSELEAVE La même signification que WM_MOUSELEAVE sauf pour la zone non cliente de la fenêtre.
WM_MOUSEHOVER La souris a survolé la zone cliente de la fenêtre pendant la période spécifiée dans un appel précédent à TrackMouseEvent. Le suivi du pointeur s’arrête lorsque ce message est généré. L’application doit appeler à nouveau TrackMouseEvent si elle nécessite un suivi supplémentaire du comportement du pointage de la souris.
WM_MOUSELEAVE La souris a quitté la zone cliente de la fenêtre spécifiée dans un appel précédent à TrackMouseEvent. Tous les suivis demandés par TrackMouseEvent sont annulés lorsque ce message est généré. L’application doit appeler TrackMouseEvent lorsque la souris entre à nouveau dans sa fenêtre si un suivi supplémentaire du comportement de pointage de la souris est nécessaire.

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winuser.h (inclure Windows.h)
Bibliothèque User32.lib
DLL User32.dll
Ensemble d’API ext-ms-win-ntuser-mouse-l1-1-0 (introduit dans Windows 8)

Voir aussi

Conceptuel

Entrées de la souris

Autres ressources

Référence

SystemParametersInfo

TRACKMOUSEEVENT

_TrackMouseEvent