WM _ HSCROLL-Meldung

Die WM _ HSCROLL-Meldung wird an ein Fenster gesendet, wenn ein Bildlaufereignis in der standardmäßigen horizontalen Scrollleiste des Fensters auftritt. Diese Meldung wird auch an den Besitzer eines horizontalen Scrollleisten-Steuerelements gesendet, wenn ein Bildlaufereignis im Steuerelement auftritt.

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

WM_HSCROLL

    WPARAM wParam
    LPARAM lParam; 

Parameter

wParam

Das HIWORD gibt die aktuelle Position des Bildlauffelds an, wenn DAS LOWORD SB THUMBPOSITION oder _ SB _ THUMBTRACK ist. Andernfalls wird dieses Wort nicht verwendet.

Das LOWORD gibt einen Bildlaufleistenwert an, der die Scrollanforderung des Benutzers angibt. Dieses Wort kann einer der folgenden Werte sein.

Wert Bedeutung
SB _ ENDSCROLL
Beendet den Bildlauf.
SB _ LEFT
Scrollt nach oben links.
SB _ RIGHT
Führt einen Bildlauf nach unten rechts durch.
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
Führt einen Bildlauf nach rechts um die Breite des Fensters aus.
SB _ THUMBPOSITION
Der Benutzer hat das Bildlauffeld (Ziehfinger) gezogen und die Maustaste losgelassen. Das HIWORD gibt die Position des Bildlauffelds am Ende des Ziehvorgang 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 Nachricht von einem Bildlaufleisten-Steuerelement gesendet wird, ist dieser Parameter das Handle für das Bildlaufleisten-Steuerelement. Wenn die Nachricht von einer Standardscrollleiste gesendet wird, ist dieser Parameter NULL.

Rückgabewert

Wenn eine Anwendung diese Nachricht verarbeitet, sollte sie 0 (null) zurückgeben.

Bemerkungen

Der SB THUMBTRACK-Anforderungscode wird in der Regel von Anwendungen verwendet, die Feedback geben, wenn der _ Benutzer das Bildlauffeld zieht.

Wenn eine Anwendung durch den Inhalt des Fensters scrollt, muss sie auch die Position des Bildlauffelds mithilfe der SetScrollPos-Funktion zurücksetzen.

Beachten Sie, dass die WM _ HSCROLL-Nachricht nur 16 Bits bildlauffeldpositionsdaten enthält. Daher haben Anwendungen, die ausschließlich WM _ HSCROLL (und WM _ VSCROLL)für Bildlaufpositionsdaten verwenden, einen praktischen maximalen Positionswert von 65.535.

Da die Funktionen SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPosund GetScrollRange jedoch 32-Bit-Bildlaufleisten-Positionsdaten unterstützen, gibt es eine Möglichkeit, die 16-Bit-Barriere der WM _ HSCROLL- und WM _ VSCROLL-Meldungen zu umgehen. Eine Beschreibung der Technik finden Sie unter GetScrollInfo.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur [ Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Winuser.h (include Windows.h)

Weitere Informationen

Verweis

GetScrollInfo

GetScrollPos

GetScrollRange

SetScrollInfo

SetScrollPos

SetScrollRange

WM _ HSCROLL (Trackleiste)

WM _ VSCROLL