Código de notificação WM_HSCROLL (Barra de Controle)

  • Artigo

A mensagem WM_HSCROLL é enviada ao proprietário de um controle de barra de controle horizontal quando o controle deslizante tiver sua posição alterada.

Uma janela recebe essa mensagem por meio da sua função WindowProc.

WM_HSCROLL

    WPARAM wParam
    LPARAM lParam;

Parâmetros

wParam

A HIWORD especifica a posição atual do controle deslizante se a LOWORD for TB_THUMBPOSITION ou TB_THUMBTRACK. Para todos os outros códigos de notificação, a palavra de ordem alta é zero; envie a mensagem TBM_GETPOS para determinar a posição do controle deslizante.

O LOWORD especifica um código de notificação que indica a interação do usuário com a barra de controle. Essa palavra pode ser um dos seguintes valores.

Valor Significado
TB_BOTTOM
 O usuário pressionou a tecla END (VK_END).
TB_ENDTRACK
 A barra de controle recebeu WM_KEYUP, o que significa que o usuário liberou uma tecla que enviou um código de tecla virtual relevante.
TB_LINEDOWN
 O usuário pressionou a tecla SETA PARA A DIREITA (VK_RIGHT) ou SETA PARA BAIXO (VK_DOWN).
TB_LINEUP
 O usuário pressionou a tecla SETA PARA A ESQUERDA (VK_LEFT) ou SETA PARA CIMA (VK_UP).
TB_PAGEDOWN
 O usuário clicou no canal abaixo ou à direita do controle deslizante (VK_NEXT).
TB_PAGEUP
 O usuário clicou no canal acima ou à esquerda do controle deslizante (VK_PRIOR).
TB_THUMBPOSITION
 A barra de controle recebeu WM_LBUTTONUP após um código de notificação TB_THUMBTRACK.
TB_THUMBTRACK
 O usuário arrastou o controle deslizante.
TB_TOP
 O usuário pressionou a tecla HOME (VK_HOME).

lParam

A alça do controle da barra de controle.

Valor retornado

Se um aplicativo processar essa mensagem, ela deverá retornar zero.

Comentários

O código TB_THUMBTRACK é normalmente utilizado por aplicativos que fornecem feedback à medida que o usuário arrasta a caixa de rolagem.

Observe que a mensagem WM_HSCROLL contém apenas 16 bits de dados de posição. Assim, os aplicativos que dependem exclusivamente de WM_HSCROLL (e WM_VSCROLL) para os dados de posição do controle deslizante têm um valor de posição máximo prático de 65.535.

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]
Cabeçalho
Winuser.h (inclui Windows.h)

Confira também

Referência

WM_VSCROLL