Funzione GetScrollBarInfo (winuser.h)

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