WM_POINTERLEAVE Nachricht

Wird an ein Fenster gesendet, wenn ein Zeiger den Erkennungsbereich über dem Fenster verlässt (Daraufzeigen) oder wenn ein Zeiger außerhalb der Grenzen des Fensters bewegt wird.

Ein Fenster empfängt diese Nachricht über die WindowProc--Funktion.

! [Wichtig]
Desktop-Apps sollten DPI-Werte beachten. Wenn Ihre App keine DPI-Werte erkennt, können Bildschirmkoordinaten, die in Zeigermeldungen und verwandten Strukturen enthalten sind, aufgrund der DPI-Virtualisierung ungenau erscheinen. Die DPI-Virtualisierung bietet automatische Skalierungsunterstützung für Anwendungen, die nicht DPI-fähig sind und standardmäßig aktiv sind (Benutzer können sie deaktivieren). Weitere Informationen finden Sie unter Writing High-DPI Win32 Applications.

#define WM_POINTERLEAVE                 0x024A

Parameter

wParam-

Enthält den Zeigerbezeichner und zusätzliche Informationen. Verwenden Sie die folgenden Makros, um diese Informationen abzurufen.

• GET_POINTERID_WPARAM(wParam): der Zeigerbezeichner.
• IS_POINTER_INRANGE_WPARAM(wParam): Gibt an, ob diese Nachricht von einem Zeiger generiert wurde, der nicht den Erkennungsbereich verlassen hat. Dieses Kennzeichen wird nicht festgelegt, wenn der Zeiger den Erkennungsbereich des Fensters verlässt.
• IS_POINTER_INCONTACT_WPARAM(wParam): ein Flag, das angibt, ob diese Nachricht von einem Zeiger generiert wurde, der sich in Kontakt befindet. Dieses Kennzeichen ist für einen Zeiger im Erkennungsbereich (Daraufzeigen) nicht festgelegt.

lParam-

Enthält die Punktposition des Zeigers.

Anmerkung

Da der Zeiger den Kontakt mit dem Gerät über einen nicht trivialen Bereich herstellen kann, kann dieser Punktstandort eine Vereinfachung eines komplexeren Zeigerbereichs darstellen. Wann immer möglich, sollte eine Anwendung anstelle der Punktposition die vollständigen Zeigerbereichsinformationen verwenden.

Verwenden Sie die folgenden Makros, um die physischen Bildschirmkoordinaten des Punkts abzurufen.

• GET_X_LPARAM(lParam): die x-Koordinate (horizontaler Punkt).
• GET_Y_LPARAM(lParam): die Y-Koordinate (vertikaler Punkt).

Rückgabewert

Wenn eine Anwendung diese Meldung verarbeitet, sollte sie Null zurückgeben.

Wenn die Anwendung diese Meldung nicht verarbeitet, sollte sie DefWindowProcaufrufen.

Bemerkungen

Die WM_POINTERLEAVE-Benachrichtigung kann von einem Fenster verwendet werden, um den Modus zu ändern oder das Feedback an den Benutzer zu beenden, während sich der Mauszeiger über der Fensteroberfläche befindet.

Diese Benachrichtigung wird nur an das Fenster gesendet, das Eingaben für den Zeiger empfängt. In der folgenden Tabelle sind einige der Situationen aufgeführt, in denen diese Benachrichtigung gesendet wird.

! [Wichtig]
Wenn ein Fenster die Erfassung eines Zeigers verliert und die WM_POINTERCAPTURECHANGED Benachrichtigung empfängt, erhält es in der Regel keine weiteren Benachrichtigungen. Aus diesem Grund ist es wichtig, dass Sie keine Annahmen basierend auf gleichmäßig gekoppelten WM_POINTERDOWN/WM_POINTERUP oder WM_POINTERENTER/WM_POINTERLEAVE Benachrichtigungen treffen.

Wenn der Kontakt mit dem Eingabedigisierer beibehalten wird und der Zeiger außerhalb des Fensters bewegt wird, wird WM_POINTERLEAVE nicht generiert. WM_POINTERLEAVE wird nur generiert, wenn ein Daraufzeiger Fensterbegrenzungen oder Kontakt überschreitet.

WM_POINTERLEAVE wird in die gepostete Nachrichtenwarteschlange gepostet, wenn die Eingabe von einem Mausgerät stammt.

Anforderungen

Siehe auch

Nachrichten

Referenz-

GET_POINTERID_WPARAM

IS_POINTER_INRANGE_WPARAM

IS_POINTER_INCONTACT_WPARAM