WM_POINTERWHEEL Meldung

Wird an das Fenster mit Vordergrundtastenfokus gesendet, wenn ein Scrollrad gedreht wird.

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

[! Wichtig]
Desktop-Apps sollten DPI-fähige Apps sein. Wenn Ihre App nicht DPI-bewusst ist, können Bildschirmkoordinaten, die in Zeigermeldungen und zugehörigen 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 Schreiben von Win32-Anwendungen mit hohem DPI-Anteil.

#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): Raddelta als Kurzwert mit Vorzeichen.

lParam

Enthält die Punktposition des Zeigers.

Hinweis

Da der Zeiger den Kontakt mit dem Gerät über einen nicht trivialen Bereich herstellen kann, kann diese Punktposition eine Vereinfachung eines komplexeren Zeigerbereichs sein. Nach Möglichkeit 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 0 (null) zurückgeben.

Wenn die Anwendung diese Nachricht nicht verarbeitet, sollte sie DefWindowProcaufrufen.

Bemerkungen

Um die Scrolleinheiten für das Rad abzurufen, verwenden Sie den InputData-Eintrag der POINTER_INFO Struktur, die durch Aufrufen der GetPointerInfo-Funktion zurückgegeben wird. Dieses Feld enthält einen Wert mit Vorzeichen und wird in einem Vielfachen von WHEEL_DELTA ausgedrückt. Ein positiver Wert gibt eine Drehung nach vorn und ein negativer Wert eine Drehung rückwärts an.

Beachten Sie, dass die Radeingaben auch dann übermittelt werden können, wenn sich der Mauszeiger außerhalb des Fensters der Anwendung befindet. Die Wheelnachrichten werden ähnlich wie die Tastatureingaben übermittelt. Das Fokusfenster der vorhergehenden Nachrichtenwarteschlange empfängt die Wheel-Nachrichten.

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