Structure TRACKMOUSEEVENT (winuser.h)

  • Article

Utilisé par la fonction TrackMouseEvent pour suivre lorsque le pointeur de la souris quitte une fenêtre ou survole une fenêtre pendant une durée déterminée.

Syntaxe

typedef struct tagTRACKMOUSEEVENT {
  DWORD cbSize;
  DWORD dwFlags;
  HWND  hwndTrack;
  DWORD dwHoverTime;
} TRACKMOUSEEVENT, *LPTRACKMOUSEEVENT;

Membres

cbSize

Type : DWORD

Taille de la structure TRACKMOUSEEVENT , en octets.

dwFlags

Type : DWORD

Services demandés. Ce membre peut être une combinaison des valeurs suivantes.

Valeur Signification
TME_CANCEL
0x80000000
 L’appelant souhaite annuler une demande de suivi antérieure. L’appelant doit également spécifier le type de suivi qu’il souhaite annuler. Par exemple, pour annuler le suivi du pointage, l’appelant doit passer les indicateurs TME_CANCEL et TME_HOVER .
TME_HOVER
0x00000001
 L’appelant souhaite une notification de pointage. La notification est remise sous la forme d’un message WM_MOUSEHOVER .

Si l’appelant demande le suivi du pointage alors que le suivi du pointage est déjà actif, le minuteur de pointage est réinitialisé.

Cet indicateur est ignoré si le pointeur de la souris ne se trouve pas sur la fenêtre ou la zone spécifiée.
TME_LEAVE
0x00000002
 L’appelant souhaite quitter la notification. La notification est remise sous la forme d’un message WM_MOUSELEAVE . Si la souris ne se trouve pas sur la fenêtre ou la zone spécifiée, une notification de congé est générée immédiatement et aucun suivi supplémentaire n’est effectué.
TME_NONCLIENT
0x00000010
 L’appelant souhaite pointer et laisser une notification pour les zones non clientes. La notification est remise sous forme de messages WM_NCMOUSEHOVER et WM_NCMOUSELEAVE .
TME_QUERY
0x40000000
 La fonction remplit la structure au lieu de la traiter comme une demande de suivi. La structure est remplie de telle sorte que si cette structure avait été passée à TrackMouseEvent, elle générerait le suivi actuel. La seule anomalie est que le délai d’attente du pointage retourné est toujours le délai d’attente réel et non HOVER_DEFAULT, si HOVER_DEFAULT a été spécifié lors de la demande TrackMouseEvent d’origine .

hwndTrack

Type : HWND

Handle de la fenêtre à suivre.

dwHoverTime

Type : DWORD

Délai d’expiration du pointage (si TME_HOVER a été spécifié dans dwFlags), en millisecondes. Peut être HOVER_DEFAULT, ce qui signifie utiliser le délai d’expiration du pointage par défaut du système.

Remarques

Le délai d’attente du pointage système par défaut est initialement le temps de liste déroulante du menu, qui est de 400 millisecondes. Vous pouvez appeler SystemParametersInfo et utiliser SPI_GETMOUSEHOVERTIME pour récupérer le délai d’attente de pointage par défaut.

Le rectangle de pointage système par défaut est identique au rectangle de double-clic. Vous pouvez appeler SystemParametersInfo et utiliser SPI_GETMOUSEHOVERWIDTH et SPI_GETMOUSEHOVERHEIGHT pour récupérer la taille du rectangle dans lequel le pointeur de la souris doit rester pour que TrackMouseEvent génère un message WM_MOUSEHOVER .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
En-tête winuser.h (inclure Windows.h)

Voir aussi

Entrées de la souris