WM_POINTERWHEEL-Meldung

  • Artikel

Wird im Fenster mit Fokus der Vordergrundtastatatur angezeigt, wenn ein Scrollrad gedreht wird.

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

![Wichtig]
Desktop-Apps sollten DPI-fähig sein. Wenn Ihre App nicht DPI-fähig ist, erscheinen bildschirmkoordinaten, die in Zeigermeldungen und zugehörigen Strukturen enthalten sind, aufgrund der DPI-Virtualisierung möglicherweise ungenau. Die DPI-Virtualisierung bietet automatische Skalierungsunterstützung für Anwendungen, die nicht DPI-fähig sind 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_POINTERWHEEL            0x024E

Parameter

wParam

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

GET_POINTERID_WPARAM(wParam): Zeigerbezeichner.

GET_WHEEL_DELTA_WPARAM(wParam): wheel delta as a signed short value.

lParam

Enthält die Punktposition des Zeigers.

Hinweis

Da der Zeiger über einen nicht trivialen Bereich Kontakt mit dem Gerät herstellen kann, kann dieser Punktstandort eine Vereinfachung eines komplexeren Zeigerbereichs darstellen. 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 die Anwendung diese Nachricht verarbeitet, sollte sie null zurückgeben.

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

Bemerkungen

Verwenden Sie zum Abrufen der Radlaufeinheiten das gespeicherte InputData-Element der POINTER_INFO-Struktur , die durch Aufrufen der GetPointerInfo-Funktion zurückgegeben wird. Dieses Feld enthält einen vorzeichenierten Wert und wird in einem Vielfachen von WHEEL_DELTA ausgedrückt. Ein positiver Wert gibt eine Drehung nach vorne an, und ein negativer Wert gibt eine Drehung nach hinten an.

Beachten Sie, dass die Radeingaben auch dann übermittelt werden können, wenn sich der Mauscursor außerhalb des Anwendungsfensters befindet. Die Radnachrichten werden in einer Weise übermittelt, die den Tastatureingaben sehr ähnlich ist. Das Fokusfenster der Warteschlange für ausgehende Nachrichten empfängt die Radnachrichten.

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