Função GetScrollBarInfo (winuser.h)
A função GetScrollBarInfo recupera informações sobre a barra de rolagem especificada.
Sintaxe
BOOL GetScrollBarInfo(
[in] HWND hwnd,
[in] LONG idObject,
[out] PSCROLLBARINFO psbi
);
Parâmetros
[in] hwnd
Tipo: HWND
Manipule para uma janela associada à barra de rolagem cujas informações devem ser recuperadas. Se o parâmetro idObject for OBJID_CLIENT, hwnd será um identificador para um controle de barra de rolagem. Caso contrário, hwnd é um identificador para uma janela criada com estilo de WS_VSCROLL e/ou WS_HSCROLL .
[in] idObject
Tipo: LONG
Especifica o objeto da barra de rolagem. Esse parâmetro pode usar um dos valores a seguir.
[out] psbi
Tipo: PSCROLLBARINFO
Ponteiro para uma estrutura SCROLLBARINFO para receber as informações. Antes de chamar GetScrollBarInfo, defina o membro cbSize como sizeof(SCROLLBARINFO).
Retornar valor
Tipo: BOOL
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Se idObject for OBJID_CLIENT e a janela especificada por hwnd não for um controle de barra de rolagem do sistema, o sistema enviará a mensagem SBM_GETSCROLLBARINFO para a janela para obter informações da barra de rolagem. Isso permite que GetScrollBarInfo opere em um controle personalizado que imita uma barra de rolagem. Se a janela não manipular a mensagem SBM_GETSCROLLBARINFO , a função GetScrollBarInfo falhará.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winuser.h (inclua Windows.h) |
| Biblioteca | User32.lib |
| DLL | User32.dll |
| Redistribuível | Service Pack 6 |
| Conjunto de APIs | ext-ms-win-ntuser-misc-l1-2-0 (introduzido no Windows 8.1) |