SBM_SETPOS Nachricht

Die SBM_SETPOS Meldung wird gesendet, um die Position des Bildlauffelds (Daumen) festzulegen, und bei Bedarf die Bildlaufleiste neu zu zeichnen, um die neue Position des Bildlauffelds widerzuspiegeln.

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

Parameter

wParam

Gibt die neue Position des Bildlauffelds an. Sie muss innerhalb des Bildlaufbereichs liegen. Wenn dieser Parameter außerhalb des Bildlaufbereichs liegt, wird der Wert auf den nächsten gültigen Wert aufgerundet oder heruntergerundet.

lParam

Gibt an, ob die Bildlaufleiste neu gezeichnet werden soll, um die neue Bildlauffeldposition widerzuspiegeln. Wenn dieser Parameter TRUE ist, wird die Bildlaufleiste neu gezeichnet. Wenn false festgelegt ist, wird die Bildlaufleiste nicht neu gezeichnet.

Rückgabewert

ComCtl32.dll Version 5.0: Wenn sich die Position des Bildlauffelds geändert hat, ist der Rückgabewert die vorherige Position des Bildlauffelds. Andernfalls ist er null.

ComCtl32.dll Version 6.0: Die aktuelle Position des Bildlauffelds, unabhängig davon, ob es sich geändert hat.

Bemerkungen

Wenn das Bildlaufleisten-Steuerelement durch einen nachfolgenden Aufruf einer anderen Funktion neu gezeichnet wird, ist das Festlegen des lParam-Parameters auf FALSE nützlich.

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

SBM_GETPOS

SBM_GETRANGE

SBM_SETRANGE

SBM_SETRANGEREDRAW