Freigeben über


SBM_GETSCROLLINFO Nachricht

Die SBM_GETSCROLLINFO Nachricht wird gesendet, um die Parameter einer Bildlaufleiste abzurufen.

Anwendungen sollten diese Nachricht nicht direkt senden. Stattdessen sollten sie die GetScrollInfo-Funktion verwenden. Ein Fenster empfängt diese Meldung über seine WindowProc-Funktion . Anwendungen, die ein benutzerdefiniertes Bildlaufleistensteuerelement implementieren, müssen auf diese Nachrichten 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 GetScrollInfo den cbSize-Member der Struktur auf sizeof(SCROLLINFO) fest, und legen Sie das fMask-Element fest, um die abzurufenden Bildlaufleistenparameter anzugeben. Vor der Rückgabe kopiert die Nachricht die angegebenen Parameter in die entsprechenden Member der -Struktur.

Der fMask-Member kann mindestens einer der folgenden Werte sein.

Wert Bedeutung
SIF_ALL
Kombination aus SIF_PAGE, SIF_POS, SIF_RANGE und SIF_TRACKPOS.
SIF_PAGE
Kopiert die Bildlaufseite in das nPage-Element.
SIF_POS
Kopiert die Bildlaufposition in das nPos-Element.
SIF_RANGE
Kopiert den Bildlaufbereich in die Elemente nMin und nMax.
SIF_TRACKPOS
Kopiert die aktuelle Nachverfolgungsposition des Bildlauffelds in das nTrackPos-Element.

Rückgabewert

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

Bemerkungen

Die Meldungen, die die Position der Bildlaufleiste angeben, WM_HSCROLL und WM_VSCROLL, stellen nur 16 Bits von Positionsdaten bereit. Die von SBM_GETSCROLLINFO, SBM_SETSCROLLINFO, GetScrollInfo und SetScrollInfo verwendete SCROLLINFO-Struktur stellt jedoch 32 Bits von Bildlaufleistenpositionsdaten bereit. Sie können diese Meldungen und Funktionen verwenden, während Sie entweder die WM_HSCROLL oder WM_VSCROLL Nachrichten verarbeiten, um 32-Bit-Bildlaufleistenpositionsdaten zu erhalten.

Um die 32-Bit-Position des Bildlauffelds (Thumb) während eines SB_THUMBTRACK Anforderungscodes in einer WM_HSCROLL - oder WM_VSCROLL-Nachricht abzurufen, senden Sie SBM_GETSCROLLINFO mit dem wert SIF_TRACKPOS 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 abrufen, während der Benutzer es bewegt. Alternativ können Sie die GetScrollInfo-Funktion verwenden, um die gleichen Informationen abzurufen.

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 (windows.h einschließen)

Siehe auch

Referenz

GetScrollInfo

SBM_SETSCROLLINFO

SCROLLINFO

SetScrollInfo