Função GetScrollBarInfo (winuser.h)

  • Artigo

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.

Valor Significado
OBJID_CLIENT
 O parâmetro hwnd é um identificador para um controle de barra de rolagem.
OBJID_HSCROLL
 A barra de rolagem horizontal da janela hwnd .
OBJID_VSCROLL
 A barra de rolagem vertical da janela hwnd .

[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)

Confira também

SCROLLBARINFO