Função EnableScrollBar (winuser.h)

  • Artigo

A função EnableScrollBar habilita ou desabilita uma ou ambas as setas da barra de rolagem.

Sintaxe

BOOL EnableScrollBar(
  [in] HWND hWnd,
  [in] UINT wSBflags,
  [in] UINT wArrows
);

Parâmetros

[in] hWnd

Tipo: HWND

Manipule para uma janela ou um controle de barra de rolagem, dependendo do valor do parâmetro wSBflags .

[in] wSBflags

Tipo: UINT

Especifica o tipo de barra de rolagem. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
SB_BOTH
 Habilita ou desabilita as setas nas barras de rolagem horizontal e vertical associadas à janela especificada. O parâmetro hWnd deve ser o identificador para a janela.
SB_CTL
 Indica que a barra de rolagem é um controle de barra de rolagem. O hWnd deve ser o identificador para o controle da barra de rolagem.
SB_HORZ
 Habilita ou desabilita as setas na barra de rolagem horizontal associada à janela especificada. O parâmetro hWnd deve ser o identificador para a janela.
SB_VERT
 Habilita ou desabilita as setas na barra de rolagem vertical associada à janela especificada. O parâmetro hWnd deve ser o identificador para a janela.

[in] wArrows

Tipo: UINT

Especifica se as setas da barra de rolagem estão habilitadas ou desabilitadas e indica quais setas estão habilitadas ou desabilitadas. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
ESB_DISABLE_BOTH
 Desabilita as duas setas em uma barra de rolagem.
ESB_DISABLE_DOWN
 Desabilita a seta para baixo em uma barra de rolagem vertical.
ESB_DISABLE_LEFT
 Desabilita a seta para a esquerda em uma barra de rolagem horizontal.
ESB_DISABLE_LTUP
 Desabilita a seta para a esquerda em uma barra de rolagem horizontal ou na seta para cima de uma barra de rolagem vertical.
ESB_DISABLE_RIGHT
 Desabilita a seta para a direita em uma barra de rolagem horizontal.
ESB_DISABLE_RTDN
 Desabilita a seta para a direita em uma barra de rolagem horizontal ou na seta para baixo de uma barra de rolagem vertical.
ESB_DISABLE_UP
 Desabilita a seta para cima em uma barra de rolagem vertical.
ESB_ENABLE_BOTH
 Habilita as duas setas em uma barra de rolagem.

Retornar valor

Tipo: BOOL

Se as setas estiverem habilitadas ou desabilitadas conforme especificado, o valor retornado será diferente de zero.

Se as setas já estiverem no estado solicitado ou ocorrer um erro, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

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)