EnableScrollBar-Funktion (winuser.h)

  • Artikel

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)