Funzione TrackMouseEvent (winuser.h)

Articolo
08/28/2023

Invia messaggi quando il puntatore del mouse lascia una finestra o passa il puntatore del mouse su una finestra per un periodo di tempo specificato.

Nota La funzione _TrackMouseEvent chiama TrackMouseEvent se esistente; in caso contrario , _TrackMouseEvent emula TrackMouseEvent.

Sintassi

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

Parametri

[in, out] lpEventTrack

Tipo: LPTRACKMOUSEEVENT

Puntatore a una struttura TRACKMOUSEEVENT che contiene informazioni di rilevamento.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Il puntatore del mouse viene considerato posizionato al passaggio del mouse quando rimane all'interno di un rettangolo specificato per un periodo di tempo specificato. Chiamare SystemParametersInfo. e usano i valori SPI_GETMOUSEHOVERWIDTH, SPI_GETMOUSEHOVERHEIGHT e SPI_GETMOUSEHOVERTIME per recuperare le dimensioni del rettangolo e l'ora.

La funzione può pubblicare i messaggi seguenti.

Message	Descrizione
WM_NCMOUSEHOVER	Lo stesso significato di WM_MOUSEHOVER tranne per l'area non client della finestra.
WM_NCMOUSELEAVE	Lo stesso significato di WM_MOUSELEAVE tranne per l'area non client della finestra.
WM_MOUSEHOVER	Il puntatore del mouse sull'area client della finestra per il periodo di tempo specificato in una chiamata precedente a TrackMouseEvent. Il rilevamento del passaggio del mouse si arresta quando viene generato questo messaggio. L'applicazione deve chiamare nuovamente TrackMouseEvent se richiede un ulteriore rilevamento del comportamento del passaggio del mouse.
WM_MOUSELEAVE	Il mouse ha lasciato l'area client della finestra specificata in una chiamata precedente a TrackMouseEvent. Tutto il rilevamento richiesto da TrackMouseEvent viene annullato quando viene generato questo messaggio. L'applicazione deve chiamare TrackMouseEvent quando il mouse richiama la finestra se richiede un ulteriore rilevamento del comportamento del passaggio del mouse.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-mouse-l1-1-0 (introdotto in Windows 8)