GetScrollBarInfo-Funktion (winuser.h)

  • Artikel

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