WM_POINTERCAPTURECHANGED Nachricht
Wird an ein Fenster gesendet, das die Erfassung eines Eingabezeigers verliert.
Ein Fenster empfängt diese Nachricht über die 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 aus der internen Verarbeitung generiert wird, kann der Wert das Handle des Fensters sein, das die Nachricht empfängt.
Rückgabewert
Wenn eine Anwendung diese Meldung verarbeitet, sollte sie Null zurückgeben.
Wenn die Anwendung diese Meldung nicht verarbeitet, sollte sie DefWindowProcaufrufen.
Bemerkungen
In einem Fenster sollte diese Benachrichtigung verwendet werden, um die Verarbeitung nachfolgenden Nachrichten zu beenden und alle für den Verlust des Zeigers erforderlichen Bereinigungen zu initiieren. Die Verarbeitung von Gesten, die dem Zeiger zugeordnet sind, sollte ebenfalls beendet werden (z. B. durch Aufrufen von StopInteractionContext) und verbleibenden Kontakten, die dem Fenster erneut zugeordnet sind.
Wenn ein Fenster die WM_POINTERCAPTURECHANGED Benachrichtigung empfängt, werden normalerweise keine nachfolgenden Benachrichtigungen im Zusammenhang mit dem Eingabezeiger empfangen. Aus diesem Fall hängen Sie nicht von gekoppelten Benachrichtigungen wie WM_POINTERENTER und WM_POINTERLEAVEab.
WM_POINTERCAPTURECHANGED enthält keine POINTER_INFO Daten. Abgesehen vom festgelegten POINTER_FLAG_CAPTURECHANGED Flag sind die von GetPointerInfo- (oder einer beliebigen Variante) zurückgegebenen Daten identisch mit denen, die vor der Benachrichtigung zurückgegeben werden.
Wenn die Anwendung diese Benachrichtigung nicht verarbeitet, kann DefWindowProc- eine oder mehrere WM_GESTURE Nachrichten generieren oder, wenn eine Geste nicht erkannt wird, DefWindowProc möglicherweise Mauseingaben generieren.
Wenn eine Anwendung selektiv zeigereingaben verwendet und den Rest an DefWindowProcübergibt, wird das resultierende Verhalten nicht definiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client |
Windows 8 [nur Desktop-Apps] |
| Mindestens unterstützter Server |
Windows Server 2012 [nur Desktop-Apps] |
| Kopfball |
|