WM_VSCROLL-Meldung

Die WM\_VSCROLL-Meldung wird an ein Fenster gesendet, wenn ein Bildlaufereignis in der standardmäßigen vertikalen Bildlaufleiste 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 Meldung über die WindowProc-Funktion.

WM_VSCROLL

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

Wert	Bedeutung
SB_BOTTOM	Scrollt nach rechts unten.
SB_ENDSCROLL	Beendet den Bildlauf.
SB_LINEDOWN	Scrollt eine Zeile nach unten.
SB_LINEUP	Scrollt eine Zeile nach oben.
SB_PAGEDOWN	Scrollt eine Seite nach unten.
SB_PAGEUP	Scrollt eine Seite nach oben.
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.
SB_TOP	Scrollt nach links oben.

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_VSCROLL-Meldung nur 16 Bit mit Bildlauffeldpositionsdaten enthält. Anwendungen, die ausschließlich auf WM_VSCROLL (und WM_HSCROLL) 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

WM_VSCROLL (Trackbar)