WM_NCPOINTERUPDATE-Meldung

Wird veröffentlicht, um eine Aktualisierung auf einem Zeiger bereitzustellen, der Kontakt über den Nicht-Clientbereich eines Fensters hergestellt hat oder wenn ein nicht erfasster Hover-Kontakt über den Nicht-Client-Bereich eines Fensters bewegt wird. Während der Mauszeiger darauf zeigt, zielt die Meldung auf das Fenster ab, über dem sich der Mauszeiger gerade befindet. Während sich der Zeiger mit der Oberfläche in Kontakt befindet, wird der Zeiger implizit in dem Fenster erfasst, über dem der Zeiger den Kontakt hergestellt hat, und dieses Fenster empfängt weiterhin Eingaben für den Zeiger, bis er den Kontakt abbricht.

Wenn der Zeiger von einem Fenster erfasst wurde, wird diese Meldung nicht gesendet. Stattdessen wird ein WM_POINTERUPDATE an das Fenster gepostet, das diesen Zeiger erfasst hat.

![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 wirken. Die DPI-Virtualisierung bietet automatische Skalierungsunterstützung für Apps, die nicht DPI-fähig und standardmäßig aktiv sind (Benutzer können sie deaktivieren). Weitere Informationen finden Sie unter Schreiben von Win32-Anwendungen mit hohem DPI-Wert.

#define WM_NCPOINTERUPDATE                 0x0241

Parameter

wParam

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

GET_POINTERID_WPARAM(wParam): Zeigerbezeichner

HIWORD(wParam): Treffertestwert, der durch Verarbeiten der WM_NCHITTEST-Meldung zurückgegeben wird.

lParam

Enthält die Punktposition des Zeigers.

Hinweis

Da der Zeiger den Kontakt mit dem Gerät möglicherweise über einen nicht trivialen Bereich herstellt, kann diese Punktposition eine Vereinfachung eines komplexeren Zeigerbereichs sein. Wann immer möglich, sollte eine Anwendung anstelle der Punktposition die vollständigen Informationen des Zeigerbereichs 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 0 (null) zurückgeben.

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

Hinweise

Wenn die Anwendung diese Meldung nicht verarbeitet, kann DefWindowProc je nach in der Nachricht enthaltenen Treffertestergebnis möglicherweise eine oder mehrere Systemaktionen ausführen. In der Regel sollten Anwendungen diese Meldung nicht verarbeiten müssen.

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 (einschließlich Windows.h)

Siehe auch

Meldungen