WM_POINTERHWHEEL Meldung
Wird an das Fenster mit Vordergrundtastenfokus gesendet, wenn ein horizontales Scrollrad gedreht wird.
Ein Fenster empfängt diese Meldung über seine WindowProc-Funktion.
[! Wichtig]
Desktop-Apps sollten DPI-bewusst 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_POINTERHWHEEL 0x024F
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. Wenn möglich, sollte eine Anwendung anstelle der Punktposition die vollständigen Zeigerbereichsinformationen 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 des Rads 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 Wheelnachrichten.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
[Windows 8 Nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
[Windows Server 2012 Nur Desktop-Apps] |
| Header |
|