WM_HSCROLL-Meldung
Die WM_HSCROLL-Meldung wird an ein Fenster gesendet, wenn ein Bildlaufereignis in der standardmäßigen horizontalen Bildlaufleiste des Fensters auftritt. Diese Meldung wird auch an den Besitzer eines horizontalen Bildlaufleisten-Steuerelements gesendet, wenn ein Bildlaufereignis im Steuerelement auftritt.
Ein Fenster empfängt diese Meldung über die WindowProc-Funktion.
WM_HSCROLL
WPARAM wParam
LPARAM lParam;
Parameter
-
wParam
-
Das HIWORD gibt die aktuelle Position des Bildlauffelds an, wenn der LOWORD-Wert SB_THUMBPOSITION oder SB_THUMBTRACK ist. Andernfalls wird dieses Wort nicht verwendet.
Das LOWORD gibt einen Bildlaufleistenwert an, der die Bildlaufanforderung des Benutzers angibt. Dieses Wort kann einen der folgenden Werte annehmen.
Wert Bedeutung - SB_ENDSCROLL
Beendet den Bildlauf. - SB_LEFT
Scrollt nach links oben. - SB_RIGHT
Scrollt nach rechts unten. - SB_LINELEFT
Scrollt um eine Einheit nach links. - SB_LINERIGHT
Scrollt um eine Einheit nach rechts. - SB_PAGELEFT
Scrollt um die Breite des Fensters nach links. - SB_PAGERIGHT
Scrollt um die Breite des Fensters nach rechts. - SB_THUMBPOSITION
Der Benutzer hat das Bildlauffeld (Daumen) gezogen und die Maustaste losgelassen. Das HIWORD gibt die Position des Bildlauffelds am Ende des Ziehvorgangs an. - SB_THUMBTRACK
Der Benutzer zieht die Bildlaufbox. Diese Meldung wird wiederholt gesendet, bis der Benutzer die Maustaste loslässt. Das HIWORD gibt die Position an, an die das Bildlauffeld gezogen wurde. -
lParam
-
Wenn die Meldung von einem Bildlaufleisten-Steuerelement gesendet wird, ist dieser Parameter der Ziehpunkt für das Bildlaufleisten-Steuerelement. Wenn die Meldung von einer standardmäßigen Bildlaufleiste gesendet wird, ist dieser Parameter NULL.
Rückgabewert
Wenn eine Anwendung diese Meldung verarbeitet, sollte sie 0 (null) zurückgeben.
Hinweise
Der SB_THUMBTRACK-Anforderungscode wird in der Regel von Anwendungen verwendet, die Feedback geben, wenn der Benutzer das Bildlauffeld zieht.
Wenn eine Anwendung den Inhalt des Fensters scrollt, muss sie auch die Position des Bildlauffelds mithilfe der SetScrollPos-Funktion zurücksetzen.
Beachten Sie, dass die WM_HSCROLL-Meldung nur 16 Bit mit Bildlauffeldpositionsdaten enthält. Anwendungen, die ausschließlich auf WM_HSCROLL (und WM_VSCROLL) für Bildlaufpositionsdaten basieren, weisen somit einen praktischen Höchstwert von 65.535 auf.
Da die Funktionen SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPosund GetScrollRange 32-Bit-Bildlaufleistenpositionsdaten unterstützen, gibt es jedoch eine Möglichkeit, die 16-Bit-Barriere der WM_HSCROLL- und WM_VSCROLL-Meldungen zu umgehen. Eine Beschreibung der Technik finden Sie unter GetScrollInfo.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| Header |
|