Função ShowScrollBar (winuser.h)

  • Artigo

A função ShowScrollBar mostra ou oculta a barra de rolagem especificada.

Sintaxe

BOOL ShowScrollBar(
  [in] HWND hWnd,
  [in] int  wBar,
  [in] BOOL bShow
);

Parâmetros

[in] hWnd

Tipo: HWND

Manipule para um controle de barra de rolagem ou uma janela com uma barra de rolagem padrão, dependendo do valor do parâmetro wBar .

[in] wBar

Tipo: int

Especifica as barras de rolagem a serem mostradas ou ocultas. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
SB_BOTH
 Mostra ou oculta as barras de rolagem horizontal e vertical padrão de uma janela.
SB_CTL
 Mostra ou oculta um controle de barra de rolagem. O parâmetro hwnd deve ser o identificador para o controle de barra de rolagem.
SB_HORZ
 Mostra ou oculta as barras de rolagem horizontais padrão de uma janela.
SB_VERT
 Mostra ou oculta a barra de rolagem vertical padrão de uma janela.

[in] bShow

Tipo: BOOL

Especifica se a barra de rolagem é mostrada ou oculta. Se esse parâmetro for TRUE, a barra de rolagem será mostrada; caso contrário, ele ficará oculto.

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

Você não deve chamar essa função para ocultar uma barra de rolagem durante o processamento de uma mensagem de barra de rolagem.

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
Conjunto de APIs ext-ms-win-ntuser-misc-l1-2-0 (introduzido no Windows 8.1)

Confira também

EnableScrollBar