EnableScrollBar-Funktion (winuser.h)

Artikel
03/06/2024

Die EnableScrollBar-Funktion aktiviert oder deaktiviert einen oder beide Scrollleistenpfeile.

Syntax

BOOL EnableScrollBar(
  [in] HWND hWnd,
  [in] UINT wSBflags,
  [in] UINT wArrows
);

Parameter

[in] hWnd

Typ: HWND

Verarbeiten Sie je nach Wert des wSBflags-Parameters ein Fenster oder ein Bildlaufleistensteuerelement.

[in] wSBflags

Typ: UINT

Gibt den Scrollleistentyp an. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
SB_BOTH	Aktiviert oder deaktiviert die Pfeile auf den horizontalen und vertikalen Bildlaufleisten, die dem angegebenen Fenster zugeordnet sind. Der hWnd-Parameter muss das Handle für das Fenster sein.
SB_CTL	Gibt an, dass es sich bei der Bildlaufleiste um ein Bildlaufleistensteuerelement handelt. Der hWnd muss der Handle für das Bildlaufleistensteuerelement sein.
SB_HORZ	Aktiviert oder deaktiviert die Pfeile auf der horizontalen Bildlaufleiste, die dem angegebenen Fenster zugeordnet ist. Der hWnd-Parameter muss das Handle für das Fenster sein.
SB_VERT	Aktiviert oder deaktiviert die Pfeile auf der vertikalen Bildlaufleiste, die dem angegebenen Fenster zugeordnet ist. Der hWnd-Parameter muss das Handle für das Fenster sein.

[in] wArrows

Typ: UINT

Gibt an, ob die Pfeile der Bildlaufleiste aktiviert oder deaktiviert sind, und gibt an, welche Pfeile aktiviert oder deaktiviert sind. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
ESB_DISABLE_BOTH	Deaktiviert beide Pfeile auf einer Bildlaufleiste.
ESB_DISABLE_DOWN	Deaktiviert den Pfeil nach unten auf einer vertikalen Bildlaufleiste.
ESB_DISABLE_LEFT	Deaktiviert den Pfeil nach links auf einer horizontalen Bildlaufleiste.
ESB_DISABLE_LTUP	Deaktiviert den Pfeil nach links auf einer horizontalen Bildlaufleiste oder den Nach-oben-Pfeil einer vertikalen Bildlaufleiste.
ESB_DISABLE_RIGHT	Deaktiviert den Pfeil nach rechts auf einer horizontalen Bildlaufleiste.
ESB_DISABLE_RTDN	Deaktiviert den Pfeil nach rechts auf einer horizontalen Bildlaufleiste oder den Abwärtspfeil einer vertikalen Bildlaufleiste.
ESB_DISABLE_UP	Deaktiviert den Pfeil nach oben auf einer vertikalen Bildlaufleiste.
ESB_ENABLE_BOTH	Aktiviert beide Pfeile auf einer Bildlaufleiste.

Rückgabewert

Typ: BOOL

Wenn die Pfeile wie angegeben aktiviert oder deaktiviert sind, ist der Rückgabewert nonzero.

Wenn sich die Pfeile bereits im angeforderten Zustand befinden oder ein Fehler auftritt, ist der Rückgabewert 0. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

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 (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-misc-l1-2-0 (eingeführt in Windows 8.1)

Share via