WM_NCPOINTERUPDATE-Nachricht

Veröffentlicht, um ein Update für einen Zeiger zur Verfügung zu stellen, der den Kontakt über den Nicht-Clientbereich eines Fensters hergestellt hat, oder wenn ein nicht gekapselter Kontakt mit dem Zeigen auf den Nicht-Clientbereich eines Fensters bewegt wird. Während der Zeiger darauf zeigt, richtet sich die Nachricht an das Fenster, über dem sich der Zeiger befindet. Während der Zeiger mit der Oberfläche in Kontakt ist, wird der Zeiger implizit auf das Fenster erfasst, über das der Zeiger kontaktiert wurde, und dieses Fenster erhält weiterhin Eingaben für den Zeiger, bis er den Kontakt unterbricht.

Wenn ein Fenster diesen Zeiger erfasst hat, wird diese Meldung nicht gesendet. Stattdessen wird ein WM_POINTERUPDATE an das Fenster gesendet, das diesen Zeiger erfasst hat.

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

#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 bei der Verarbeitung der WM_NCHITTEST zurückgegeben wird.

lParam

Enthält die Punktposition des Zeigers.

Hinweis

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

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

Bemerkungen

Wenn die Anwendung diese Nachricht nicht verarbeiten kann, kann DefWindowProc je nach treffertestbasiertem Ergebnis, das in der Nachricht enthalten ist, eine oder mehrere Systemaktionen ausführen. In der Regel sollten Anwendungen diese Meldung nicht verarbeiten müssen.

Requirements (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 (include Windows.h)

Weitere Informationen

Meldungen