Condividi tramite


Funzione TrackMouseEvent (winuser.h)

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)

Vedi anche

Informazioni concettuali

Mouse Input

Altre risorse

Riferimento

Systemparametersinfo

TRACKMOUSEEVENT

_TrackMouseEvent