Funzione GetScrollBarInfo (winuser.h)

Articolo
08/27/2023

La funzione GetScrollBarInfo recupera informazioni sulla barra di scorrimento specificata.

Sintassi

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

Parametri

[in] hwnd

Tipo: HWND

Handle in una finestra associata alla barra di scorrimento le cui informazioni devono essere recuperate. Se il parametro idObject è OBJID_CLIENT, hwnd è un handle per un controllo barra di scorrimento. In caso contrario, hwnd è un handle per una finestra creata con stile WS_VSCROLL e/o WS_HSCROLL .

[in] idObject

Tipo: LONG

Specifica l'oggetto barra di scorrimento. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
OBJID_CLIENT	Il parametro hwnd è un handle per un controllo barra di scorrimento.
OBJID_HSCROLL	Barra di scorrimento orizzontale della finestra visualizzata.
OBJID_VSCROLL	Barra di scorrimento verticale della finestra hwnd .

[out] psbi

Tipo: PSCROLLBARINFO

Puntatore a una struttura SCROLLBARINFO per ricevere le informazioni. Prima di chiamare GetScrollBarInfo, impostare il membro cbSize su sizeof(SCROLLBARINFO).

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Se idObject è OBJID_CLIENT e la finestra specificata da hwnd non è un controllo barra di scorrimento di sistema, il sistema invia il messaggio SBM_GETSCROLLBARINFO alla finestra per ottenere informazioni sulla barra di scorrimento. Ciò consente a GetScrollBarInfo di operare su un controllo personalizzato che simula una barra di scorrimento. Se la finestra non gestisce il messaggio SBM_GETSCROLLBARINFO , la funzione GetScrollBarInfo ha esito negativo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Componente ridistribuibile	Service Pack 6
Set di API	ext-ms-win-ntuser-misc-l1-2-0 (introdotto in Windows 8.1)

Vedi anche

SCROLLBARINFO

Condividi tramite