SBM_SETSCROLLINFO mensagem

  • Artigo

A mensagem SBM_SETSCROLLINFO é enviada para definir 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 SetScrollInfo . 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 SetScrollInfo funcione corretamente.

Parâmetros

wParam

Especifica se a barra de rolagem é redesenhada para refletir a nova posição da caixa de rolagem. Se esse parâmetro for TRUE, a barra de rolagem será redesenhada. Se for FALSE, a barra de rolagem não será redesenhada.

lParam

Ponteiro para uma estrutura SCROLLINFO . Antes de chamar SetScrollInfo, defina o membro cbSize da estrutura como sizeof(SCROLLINFO), defina o membro fMask para indicar os parâmetros a serem definidos e especifique os novos valores de parâmetro nos membros apropriados.

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

Valor Significado
SIF_DISABLENOSCROLL
 Desabilita a barra de rolagem em vez de removê-la, se os novos parâmetros da barra de rolagem tornam a barra de rolagem desnecessária.
SIF_PAGE
 Define a página de rolagem para o valor especificado no membro nPage .
SIF_POS
 Define a posição de rolagem para o valor especificado no membro nPos .
SIF_RANGE
 Define o intervalo de rolagem para o valor especificado nos membros nMin e nMax .

Retornar valor

O valor retornado é a posição atual da caixa de rolagem.

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 de WM_HSCROLL ou WM_VSCROLL para obter dados de posição da barra de rolagem de 32 bits.

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_GETSCROLLINFO

SCROLLINFO

Setscrollinfo