TrackMouseEvent, fonction (winuser.h)

Article
08/28/2023

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)