Compartilhar via


SBM_SETPOS mensagem

A mensagem SBM_SETPOS é enviada para definir a posição da caixa de rolagem (polegar) e, se solicitada, redesenhar a barra de rolagem para refletir a nova posição da caixa de rolagem.

Os aplicativos não devem enviar essa mensagem diretamente. Em vez disso, eles devem usar a função SetScrollPos . 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 SetScrollPos funcione corretamente.

Parâmetros

wParam

Especifica a nova posição da caixa de rolagem. Ela deve ficar dentro do intervalo de rolagem. Se esse parâmetro estiver fora do intervalo de rolagem, o valor será arredondado para cima ou para baixo até o valor válido mais próximo.

lParam

Especifica se a barra de rolagem deve ser 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.

Retornar valor

ComCtl32.dll versão 5.0: se a posição da caixa de rolagem for alterada, o valor retornado será a posição anterior da caixa de rolagem; caso contrário, é zero.

ComCtl32.dll versão 6.0: a posição atual da caixa de rolagem, independentemente de ter sido alterada.

Comentários

Se o controle de barra de rolagem for redesenhado por uma chamada subsequente para outra função, definir o parâmetro lParam como FALSE será útil.

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

SBM_GETPOS

SBM_GETRANGE

SBM_SETRANGE

SBM_SETRANGEREDRAW