WM_HSCROLL mensagem

A mensagem de WM_HSCROLL é enviada para uma janela quando um evento de rolagem ocorre na barra de rolagem horizontal padrão da janela. Essa mensagem também é enviada ao proprietário de um controle de barra de rolagem horizontal quando ocorre um evento de rolagem no controle.

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

WM_HSCROLL

    WPARAM wParam
    LPARAM lParam; 

Parâmetros

wParam

O HIWORD especifica a posição atual da caixa de rolagem se o LOWORD for SB_THUMBPOSITION ou SB_THUMBTRACK; caso contrário, essa palavra não será usada.

O LOWORD especifica um valor de barra de rolagem que indica a solicitação de rolagem do usuário. Essa palavra pode ser um dos valores a seguir.

Valor Significado
SB_ENDSCROLL
Termina a rolagem.
SB_LEFT
Rola até o canto superior esquerdo.
SB_RIGHT
Rola para o canto inferior direito.
SB_LINELEFT
Rola para a esquerda por uma unidade.
SB_LINERIGHT
Rola para a direita por uma unidade.
SB_PAGELEFT
Rola para a esquerda pela largura da janela.
SB_PAGERIGHT
Rola para a direita pela largura da janela.
SB_THUMBPOSITION
O usuário arrastou a caixa de rolagem (polegar) e liberou o botão do mouse. O HIWORD indica a posição da caixa de rolagem no final da operação de arrastar.
SB_THUMBTRACK
O usuário está arrastando a caixa de rolagem. Essa mensagem é enviada repetidamente até que o usuário libere o botão do mouse. O HIWORD indica a posição para a qual a caixa de rolagem foi arrastada.

lParam

Se a mensagem for enviada por um controle de barra de rolagem, esse parâmetro será o identificador para o controle da barra de rolagem. Se a mensagem for enviada por uma barra de rolagem padrão, esse parâmetro será NULL.

Retornar valor

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

Comentários

O código de solicitação SB_THUMBTRACK normalmente é usado por aplicativos que fornecem comentários à medida que o usuário arrasta a caixa de rolagem.

Se um aplicativo rolar o conteúdo da janela, ele também deverá redefinir a posição da caixa de rolagem usando a função SetScrollPos .

Observe que a mensagem WM_HSCROLL carrega apenas 16 bits de dados de posição da caixa de rolagem. Assim, os aplicativos que dependem apenas de WM_HSCROLL (e WM_VSCROLL) para dados de posição de rolagem têm um valor de posição máxima prático de 65.535.

No entanto, como as funções SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPos e GetScrollRange dão suporte a dados de posição da barra de rolagem de 32 bits, há uma maneira de contornar a barreira de 16 bits das mensagens WM_HSCROLL e WM_VSCROLL . Consulte GetScrollInfo para obter uma descrição da técnica.

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 (inclua Windows.h)

Confira também

Referência

Getscrollinfo

GetScrollPos

GetScrollRange

Setscrollinfo

Setscrollpos

Setscrollrange

WM_HSCROLL (barra de controle)

WM_VSCROLL