WM_NCPOINTERDOWN-Meldung

Wird gepostet, wenn ein Zeiger Kontakt über den Nicht-Clientbereich eines Fensters herstellt. Die Nachricht zielt auf das Fenster ab, über das der Zeiger Kontakt herstellt. Der Zeiger wird implizit im Fenster erfasst, sodass das Fenster weiterhin Eingaben für den Zeiger empfängt, bis der Kontakt unterbrochen wird.

Wenn der Zeiger von einem Fenster erfasst wurde, wird diese Meldung nicht gesendet. Stattdessen wird eine WM_POINTERDOWN-Meldung in 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_NCPOINTERDOWN                 0x0242

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