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	Winuser.h (einschließlich Windows.h)

Siehe auch

Referenz

GetScrollInfo

GetScrollPos

GetScrollRange

SetScrollInfo

SetScrollPos

SetScrollRange

WM_HSCROLL (Trackbar)

WM_VSCROLL