SBM_GETSCROLLINFO mensagem

A mensagem SBM_GETSCROLLINFO é enviada para recuperar os parâmetros de uma barra de rolagem.

Os aplicativos não devem enviar essa mensagem diretamente. Em vez disso, eles devem usar a função GetScrollInfo . Uma janela recebe essa mensagem por meio da função WindowProc. Os aplicativos que implementam um controle de barra de rolagem personalizado devem responder a essas mensagens para que a função GetScrollInfo funcione corretamente.

Parâmetros

wParam

Este parâmetro não é usado.

lParam

Ponteiro para uma estrutura SCROLLINFO . Antes de chamar GetScrollInfo, defina o membro cbSize da estrutura como sizeof (SCROLLINFO) e defina o membro fMask para especificar os parâmetros da barra de rolagem a serem recuperados. Antes de retornar, a mensagem copia os parâmetros especificados para os membros apropriados da estrutura.

O membro fMask pode ser um ou mais dos valores a seguir.

Valor	Significado
SIF_ALL	Combinação de SIF_PAGE, SIF_POS, SIF_RANGE e SIF_TRACKPOS.
SIF_PAGE	Copia a página de rolagem para o membro nPage.
SIF_POS	Copia a posição de rolagem para o membro nPos.
SIF_RANGE	Copia o intervalo de rolagem para os membros nMin e nMax.
SIF_TRACKPOS	Copia a posição de acompanhamento da caixa de rolagem atual para o membro nTrackPos.

Retornar valor

Se a mensagem tiver recuperado valores, o valor retornado será TRUE; caso contrário, será FALSE.

Comentários

As mensagens que indicam a posição da barra de rolagem, WM_HSCROLL e WM_VSCROLL, fornecem apenas 16 bits de dados de posição. No entanto, a estrutura SCROLLINFO usada por SBM_GETSCROLLINFO, SBM_SETSCROLLINFO, GetScrollInfo e SetScrollInfo fornece 32 bits de dados de posição da barra de rolagem. Você pode usar essas mensagens e funções durante o processamento das mensagens WM_HSCROLL ou WM_VSCROLL para obter dados de posição da barra de rolagem de 32 bits.

Para obter a posição de 32 bits da caixa de rolagem (polegar) durante um código de solicitação SB_THUMBTRACK em uma mensagem de WM_HSCROLL ou WM_VSCROLL , envie SBM_GETSCROLLINFO com o valor SIF_TRACKPOS no membro fMask da estrutura SCROLLINFO . A mensagem retorna a posição de acompanhamento da caixa de rolagem no membro nTrackPos da estrutura SCROLLINFO . Isso permite que você obtenha a posição da caixa de rolagem à medida que o usuário a move. Como alternativa, você pode usar a função GetScrollInfo para obter as mesmas informações.

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

Getscrollinfo

SBM_SETSCROLLINFO

SCROLLINFO

Setscrollinfo