SBM_SETSCROLLINFO Nachricht

Die SBM_SETSCROLLINFO Nachricht wird gesendet, um die Parameter einer Bildlaufleiste festzulegen.

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

Parameter

wParam

Gibt an, ob die Bildlaufleiste neu gezeichnet wird, um die neue Position des Bildlauffelds widerzuspiegeln. Wenn dieser Parameter TRUE ist, wird die Bildlaufleiste neu gezeichnet. Wenn sie FALSE ist, wird die Bildlaufleiste nicht neu gezeichnet.

lParam

Zeiger auf eine SCROLLINFO-Struktur . Legen Sie vor dem Aufrufen von SetScrollInfo das cbSize-Element der Struktur auf sizeof(SCROLLINFO) fest, legen Sie das fMask-Element fest, um die festzulegenden Parameter anzugeben, und geben Sie die neuen Parameterwerte in den entsprechenden Membern an.

Das fMask-Element kann mindestens einer der folgenden Werte sein.

Wert Bedeutung
SIF_DISABLENOSCROLL
Deaktiviert die Bildlaufleiste, anstatt sie zu entfernen, wenn die neuen Parameter der Bildlaufleiste die Bildlaufleiste unnötig machen.
SIF_PAGE
Legt die Bildlaufseite auf den wert fest, der im nPage-Element angegeben ist.
SIF_POS
Legt die Bildlaufposition auf den im nPos-Element angegebenen Wert fest.
SIF_RANGE
Legt den Bildlaufbereich auf den in den Membern nMin und nMax angegebenen Wert fest.

Rückgabewert

Der Rückgabewert ist die aktuelle Position des Bildlauffelds.

Bemerkungen

Die Meldungen, die die Position der Bildlaufleiste angeben, WM_HSCROLL und WM_VSCROLL, enthalten nur 16 Bit Positionsdaten. Die von SBM_GETSCROLLINFO, SBM_SETSCROLLINFO, GetScrollInfo und SetScrollInfo verwendete SCROLLINFO-Struktur stellt jedoch 32 Bits an Bildlaufleistenpositionsdaten bereit. Sie können diese Nachrichten und Funktionen verwenden, während Sie entweder die WM_HSCROLL oder WM_VSCROLL Nachrichten verarbeiten, um 32-Bit-Bildlaufleistenpositionsdaten 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 (einschließlich Windows.h)

Siehe auch

Referenz

GetScrollInfo

SBM_GETSCROLLINFO

SCROLLINFO

SetScrollInfo