TrackMouseEvent-Funktion (winuser.h)

Artikel
08/28/2023

Sendet Nachrichten, wenn der Mauszeiger ein Fenster verlässt oder für eine bestimmte Zeit auf ein Fenster zeigt.

Hinweis Die _TrackMouseEvent-Funktion ruft TrackMouseEvent auf, sofern vorhanden, andernfalls emuliert _TrackMouseEventTrackMouseEvent.

Syntax

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

Parameter

[in, out] lpEventTrack

Typ: LPTRACKMOUSEEVENT

Ein Zeiger auf eine TRACKMOUSEEVENT-Struktur , die Nachverfolgungsinformationen enthält.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich null.

Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Der Mauszeiger gilt als mit dem Mauszeiger, wenn er für einen bestimmten Zeitraum innerhalb eines angegebenen Rechtecks bleibt. Rufen Sie SystemParametersInfo auf. und verwenden Sie die Werte SPI_GETMOUSEHOVERWIDTH, SPI_GETMOUSEHOVERHEIGHT und SPI_GETMOUSEHOVERTIME , um die Größe des Rechtecks und die Uhrzeit abzurufen.

Die Funktion kann die folgenden Meldungen posten.

`Message`	BESCHREIBUNG
WM_NCMOUSEHOVER	Die gleiche Bedeutung wie WM_MOUSEHOVER außer für den Nichtclientbereich des Fensters.
WM_NCMOUSELEAVE	Die gleiche Bedeutung wie WM_MOUSELEAVE außer für den Nichtclientbereich des Fensters.
WM_MOUSEHOVER	Die Maus bewegte den Mauszeiger über den Clientbereich des Fensters für den Zeitraum, der in einem vorherigen Aufruf von TrackMouseEvent angegeben wurde. Die Nachverfolgung des Mauszeigers wird beendet, wenn diese Meldung generiert wird. Die Anwendung muss TrackMouseEvent erneut aufrufen, wenn sie eine weitere Nachverfolgung des Mauszeigerverhaltens erfordert.
WM_MOUSELEAVE	Die Maus hat den Clientbereich des Fensters verlassen, das vor einem Aufruf von TrackMouseEvent angegeben wurde. Die gesamte von TrackMouseEvent angeforderte Nachverfolgung wird abgebrochen, wenn diese Meldung generiert wird. Die Anwendung muss TrackMouseEvent aufrufen, wenn die sie eine weitere Nachverfolgung des Mauszeigerverhaltens erfordert und die Maus das Fenster erneut aufruft.

Anforderungen


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-mouse-l1-1-0 (eingeführt in Windows 8)