SetScrollPos

O SetScrollPos função define a posição do caixa de rolagem (polegar) na barra de rolagem especificado e, se solicitado, redesenha a barra de rolagem para refletir a Novo posição da caixa de rolagem.

O SetScrollPos função é fornecida para compatibilidade com versões anteriores. Novos aplicativos devem usar o SetScrollInfo função.

int (SetScrollPos HWND  hWnd, / / identificador para janela com barra de rolagemintnBar, / / scroll barra bandeiraintassociações sem fins lucrativos, / / novo posição da caixa de rolagemBOOLbRedraw / / redesenhar bandeira);
 

Parâmetros

hWnd

Identificador para um Controlarar de barra de rolagem ou uma janela com uma padrão barra de rolagem, depending on o valor do parâmetro nBar.

nBar

Especifica a barra de rolagem a ser definido. Este parâmetro pode ser uma dos seguinte valores:

Valor	Significado
SB_CTL	Define a posição do caixa de rolagem em um Controlarar de barra de rolagem. O parâmetro de hWnd deve ser o identificador para o Controlarar de barra de rolagem.
SB_HORZ	Define a posição de rolagem caixa na barra de rolagem horizontal padrão da janela.
SB_VERT	Define a posição de rolagem caixa na barra de rolagem vertical padrão da janela.

associações sem fins lucrativos

Especifica a Novo posição da caixa de rolagem. A posição deve ser dentro de intervalo de rolagem. Para obter mais informações sobre o intervalo de rolagem, consulte o SetScrollRange função.

bRedraw

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

Retornar valores

Se a função for bem-sucedido, o valor de retorno é a posição anterior do caixa de rolagem.

Se a função falhar, o valor de retorno é zero. Para informações de erro estendidas get, chamar GetLastError.

Observações

Se a barra de rolagem é redesenhada por um chamar subseqüente para outra função, configuração bRedraw parâmetro para FALSE é útil.

Como as mensagens que indicam posição barra de rolagem, WM_HSCROLL e WM_VSCROLL, são limitadas a 16 bits de dados posição, os aplicativos que dependem exclusivamente essas mensagens para dados posição têm um valor máximo prático de 65.535 para nPos parâmetro o SetScrollPos da função.

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.

QuickInfo

nbsp; Windows &NT: requer a versão 3.1 ou posterior.
Windows:Requer o Windows 95 ou posterior.
Windows CE:Requer a versão 2.0 ou posterior.
Cabeçalho:Declarado em WinUser. h.
Biblioteca de importação:Use user32.lib.

Ver também

Visão geral de barras de rolagem, barra de rolagem funções, GetScrollInfo, GetScrollPos, GetScrollRange, SetScrollInfo, SetScrollRange

Index