TrackMouseEvent-Funktion (winuser.h)
Sendet Nachrichten, wenn der Mauszeiger ein Fenster verlässt oder für eine bestimmte Zeit auf ein Fenster zeigt.
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) |
Siehe auch
Konzept
Andere Ressourcen
Referenz