ShowScrollBar-Funktion (winuser.h)

Artikel
03/04/2024

Die ShowScrollBar-Funktion blendet die angegebene Bildlaufleiste ein oder aus.

Syntax

BOOL ShowScrollBar(
  [in] HWND hWnd,
  [in] int  wBar,
  [in] BOOL bShow
);

Parameter

[in] hWnd

Typ: HWND

Handle für ein Bildlaufleisten-Steuerelement oder ein Fenster mit einer Standard-Bildlaufleiste, je nach Wert des wBar-Parameters .

[in] wBar

Typ: int

Gibt die Bildlaufleiste(n) an, die ein- oder ausgeblendet werden sollen. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
SB_BOTH	Blendet die standardmäßigen horizontalen und vertikalen Bildlaufleisten eines Fensters ein oder aus.
SB_CTL	Blendet ein Bildlaufleisten-Steuerelement ein oder aus. Der hwnd-Parameter muss das Handle für das Bildlaufleisten-Steuerelement sein.
SB_HORZ	Blendet die standardmäßigen horizontalen Bildlaufleisten eines Fensters ein oder aus.
SB_VERT	Blendet die standardmäßige vertikale Bildlaufleiste eines Fensters ein oder aus.

[in] bShow

Typ: BOOL

Gibt an, ob die Bildlaufleiste angezeigt oder ausgeblendet wird. Wenn dieser Parameter TRUE ist, wird die Bildlaufleiste angezeigt. Andernfalls ist es ausgeblendet.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Sie sollten diese Funktion nicht aufrufen, um eine Bildlaufleiste während der Verarbeitung einer Bildlaufleistennachricht auszublenden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-misc-l1-2-0 (eingeführt in Windows 8.1)

Weitere Informationen

EnableScrollBar

Freigeben über