GetScrollBarInfo-Funktion (winuser.h)

Artikel
08/27/2023

Die GetScrollBarInfo-Funktion ruft Informationen zur angegebenen Bildlaufleiste ab.

Syntax

BOOL GetScrollBarInfo(
  [in]  HWND           hwnd,
  [in]  LONG           idObject,
  [out] PSCROLLBARINFO psbi
);

Parameter

[in] hwnd

Typ: HWND

Handle für ein Fenster, das der Bildlaufleiste zugeordnet ist, deren Informationen abgerufen werden sollen. Wenn der parameter idObject OBJID_CLIENT ist, ist hwnd ein Handle für ein Bildlaufleistensteuerelement. Andernfalls ist hwnd ein Handle für ein Fenster, das mit WS_VSCROLL und/oder WS_HSCROLL Stil erstellt wurde.

[in] idObject

Typ: LONG

Gibt das Bildlaufleistenobjekt an. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert	Bedeutung
OBJID_CLIENT	Der hwnd-Parameter ist ein Handle für ein Bildlaufleisten-Steuerelement.
OBJID_HSCROLL	Die horizontale Bildlaufleiste des hwnd-Fensters .
OBJID_VSCROLL	Die vertikale Bildlaufleiste des hwnd-Fensters .

[out] psbi

Typ: PSCROLLBARINFO

Zeiger auf eine SCROLLBARINFO-Struktur , um die Informationen zu empfangen. Legen Sie vor dem Aufrufen von GetScrollBarInfo das element cbSize auf sizeof(SCROLLBARINFO) fest.

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

Wenn idObject OBJID_CLIENT ist und das von hwnd angegebene Fenster kein System-Bildlaufleisten-Steuerelement ist, sendet das System die SBM_GETSCROLLBARINFO Meldung an das Fenster, um Bildlaufleisteninformationen abzurufen. Dadurch kann GetScrollBarInfo mit einem benutzerdefinierten Steuerelement arbeiten, das eine Bildlaufleiste imitiert. Wenn das Fenster die SBM_GETSCROLLBARINFO Meldung nicht verarbeitet, schlägt die GetScrollBarInfo-Funktion fehl.

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
Verteilbare Komponente	Service Pack 6
APIs	ext-ms-win-ntuser-misc-l1-2-0 (eingeführt in Windows 8.1)

Weitere Informationen

SCROLLBARINFO

Freigeben über