WM_POINTERCAPTURECHANGED-Meldung

Wird an ein Fenster gesendet, das die Erfassung eines Eingabezeigers verliert.

Ein Fenster empfängt diese Meldung über seine WindowProc-Funktion .

#define WM_POINTERCAPTURECHANGED           0x024C

Parameter

wParam

Enthält Informationen zum Eingabezeiger, der verloren geht. Verwenden Sie GET_POINTERID_WPARAM , um die Zeiger-ID abzurufen.

lParam

Enthält ein Handle für das Fenster, das den Eingabezeiger erfasst. Dieser Wert kann NULL sein, wenn der Zeiger nicht mehr vom Fenster erfasst wird.

Wenn diese Nachricht von der internen Verarbeitung generiert wird, kann der Wert das Handle des Fensters sein, das die Nachricht empfängt.

Rückgabewert

Wenn eine Anwendung diese Nachricht verarbeitet, sollte sie null zurückgeben.

Wenn die Anwendung diese Nachricht nicht verarbeitet, sollte sie DefWindowProc aufrufen.

Bemerkungen

Ein Fenster sollte diese Benachrichtigung verwenden, um die Verarbeitung nachfolgender Nachrichten zu beenden und alle Bereinigungen zu initiieren, die für den Verlust des Zeigers erforderlich sind. Die Verarbeitung von Gesten, die dem Zeiger zugeordnet sind, sollte ebenfalls beendet werden (z. B. durch Aufrufen von StopInteractionContext), und die verbleibenden Kontakte sollten dem Fenster erneut zugeordnet werden.

Wenn ein Fenster die WM_POINTERCAPTURECHANGED Benachrichtigung empfängt, werden in der Regel keine nachfolgenden Benachrichtigungen im Zusammenhang mit dem Eingabezeiger empfangen. Verlassen Sie sich daher nicht auf gekoppelte Benachrichtigungen wie WM_POINTERENTER und WM_POINTERLEAVE.

WM_POINTERCAPTURECHANGED enthält keine POINTER_INFO Daten. Mit Ausnahme des POINTER_FLAG_CAPTURECHANGED-Flags , das festgelegt wird, sind die von GetPointerInfo (oder einer beliebigen Variante) zurückgegebenen Daten mit denen identisch, die vor der Benachrichtigung zurückgegeben wurden.

Wenn die Anwendung diese Benachrichtigung nicht verarbeitet, generiert DefWindowProc möglicherweise eine oder mehrere WM_GESTURE Meldungen, oder wenn eine Geste nicht erkannt wird, generiert DefWindowProc möglicherweise Mauseingaben.

Wenn eine Anwendung selektiv Zeigereingaben nutzt und den Rest an DefWindowProc übergibt, ist das resultierende Verhalten nicht definiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Header	Winuser.h (windows.h einschließen)

Siehe auch

Meldungen