SBM _ GETSCROLLINFO-Nachricht

Die SBM _ GETSCROLLINFO-Nachricht wird gesendet, um die Parameter einer Scrollleiste abzurufen.

Anwendungen sollten diese Nachricht nicht direkt senden. Stattdessen sollten sie die GetScrollInfo-Funktion verwenden. Ein Fenster empfängt diese Nachricht über seine WindowProc-Funktion. Anwendungen, die ein benutzerdefiniertes Bildlaufleisten-Steuerelement implementieren, müssen auf diese Meldungen reagieren, damit die GetScrollInfo-Funktion ordnungsgemäß funktioniert.

Parameter

wParam

Dieser Parameter wird nicht verwendet.

lParam

Zeiger auf eine SCROLLINFO-Struktur. Legen Sie vor dem Aufrufen von GetScrollInfodas cbSize-Element der -Struktur auf sizeof(SCROLLINFO) fest, und legen Sie das fMask-Element fest, um die abzurufenden Scrollleistenparameter anzugeben. Vor der Rückgabe kopiert die Meldung die angegebenen Parameter in die entsprechenden Member der -Struktur.

Der fMask-Member kann einer oder mehrere der folgenden Werte sein.

Wert Bedeutung
SIF _ ALL
Kombination aus SIF _ PAGE, SIF _ POS, SIF _ RANGE und SIF _ TRACKPOS.
_SIF-SEITE
Kopiert die Scrollseite in das nPage-Member.
SIF _ POS
Kopiert die Scrollposition in das nPos-Member.
_SIF-BEREICH
Kopiert den Bildlaufbereich in die Member nMin und nMax.
SIF _ TRACKPOS
Kopiert die aktuelle Position der Bildlauffeldnachverfolgung in das nTrackPos-Mitglied.

Rückgabewert

Wenn die Nachricht Werte abgerufen hat, ist der Rückgabewert TRUE. Andernfalls ist dies FALSE.

Bemerkungen

Die Meldungen, die die Position der Scrollleiste (WM _ HSCROLL und WM _ VSCROLL)angeben, stellen nur 16 Bits an Positionsdaten zur Verfügung. Die von SBM _ GETSCROLLINFO, SBM _ SETSCROLLINFO, GetScrollInfound SetScrollInfo verwendete SCROLLINFO-Struktur stellt jedoch 32 Bits bildlaufleistenpositionsdaten zur Seite. Sie können diese Nachrichten und Funktionen beim Verarbeiten der WM _ HSCROLL- oder WM _ VSCROLL-Nachrichten verwenden, um 32-Bit-Bildlaufleisten-Positionsdaten zu erhalten.

Um die 32-Bit-Position des Bildlauffelds (Ziehpunkt) während eines SB THUMBTRACK-Anforderungscodes in einer _ WM _ HSCROLL- oder WM _ VSCROLL-Nachricht zu erhalten, senden Sie SBM _ GETSCROLLINFO mit dem SIF _ TRACKPOS-Wert im fMask-Element der SCROLLINFO-Struktur. Die Meldung gibt die Nachverfolgungsposition des Bildlauffelds im nTrackPos-Element der SCROLLINFO-Struktur zurück. Dadurch können Sie die Position des Bildlauffelds beim Bewegen des Bildlauffelds durch den Benutzer erhalten. Alternativ können Sie die GetScrollInfo-Funktion verwenden, um die gleichen Informationen zu erhalten.

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

Referenz

GetScrollInfo

SBM _ SETSCROLLINFO

SCROLLINFO

SetScrollInfo