A mensagem WM_HSCROLL é enviada para uma janela quando ocorre um evento de rolagem na barra de rolagem horizontal padrão da janela. Esta mensagem também é enviada para o proprietário de um Controlarar de barra de rolagem horizontal quando ocorre um evento de rolagem no controle.
WM_HSCROLL nScrollCode = (int) LOWORD(wParam); / / scroll barra nPos valor = (short int) HIWORD(wParam); / / Role caixa posição hwndScrollBar = lParam (HWND); / / identificador para rolar barra
| Valor | Significado |
|---|---|
| SB_ENDSCROLL | Rolagem extremidades. |
| SB_LEFT | Rola para o canto superior esquerdo. |
| SB_RIGHT | Rola para o canto inferior direito. |
| SB_LINELEFT | Rola esquerda por uma unidade. |
| SB_LINERIGHT | Rola da direito por uma unidade. |
| SB_PAGELEFT | Rola esquerda pela largura da janela. |
| SB_PAGERIGHT | Rola da direito pela largura da janela. |
| SB_THUMBPOSITION | O usuário tiver arrastado da caixa de rolagem (polegar) e lançado o botão do mouse. O nPos parâmetro indica a posição do caixa de rolagem no final da operação arrastar. |
| SB_THUMBTRACK | O usuário é arrastar a caixa de rolagem. Esta mensagem é enviada repetidamente até que o usuário libera o botão do mouse. O nPos parâmetro indica a posição que foi arrastada da caixa de rolagem para. |
Se um aplicativo processa esta mensagem, ela deve retornar zero.
A notificação de mensagem SB_THUMBTRACK é geralmente usada por aplicativos que fornecem comentários como o usuário arrasta a caixa de rolagem.
Se um aplicativo rola o conteúdo da janela, ele também deve redefinir a posição do caixa de rolagem, usando o SetScrollPos função.
Observe que a mensagem WM_HSCROLL carrega apenas 16 bits de dados posição da caixa de rolagem. Assim, os aplicativos que dependem exclusivamente de WM_HSCROLL (e WM_VSCROLL) para rolagem posição dados têm um valor posição máximo prático de 65.535.
No entanto, porque o SetScrollInfo, SetScrollPos, SetScrollRange, GetScrollInfo, GetScrollPose funções GetScrollRange suportam dados de posição de barra de rolagem 32 bits, há uma maneira de contornar a barreira de 16-bit das mensagens WM_HSCROLL e WM_VSCROLL. Consulte GetScrollInfo para uma descrição da técnica.
nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer versão 1.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Visão geral de barras de rolagem, mensagens de barra de rolagem, GetScrollInfo, GetScrollPos, GetScrollRange, SetScrollInfo, SetScrollPos, SetScrollRange, WM_VSCROLL