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

Confira também

SCROLLBARINFO