WM _ VSCROLL-Meldung

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

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

WM_VSCROLL

    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. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
SB _ BOTTOM
Führt einen Bildlauf nach unten rechts durch.
SB _ ENDSCROLL
Beendet den Bildlauf.
SB _ LINEDOWN
Führt einen Bildlauf um eine Zeile nach unten aus.
SB _ LINEUP
Führt einen Bildlauf um eine Zeile nach oben aus.
SB _ PAGEDOWN
Führt einen Bildlauf um eine Seite nach unten aus.
SB _ PAGEUP
Führt einen Bildlauf um eine Seite nach oben 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.
SB _ TOP
Scrollt nach oben links.

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 _ VSCROLL-Nachricht nur 16 Bits bildlauffeldpositionsdaten enthält. Daher haben Anwendungen, die ausschließlich WM _ VSCROLL (und WM _ HSCROLL)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

WM _ VSCROLL (Trackbar)