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 |
|