SetScrollRange

O SetScrollRange função define os valores mínimo e máximo posição para o barra de rolagem especificado.

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

 (BOOL SetScrollRange HWND  hWnd, / / identificador para janela com barra de rolagemintnBar, / / scroll barra bandeiraintnMinPos, / / mínimo rolagem posiçãointnMaxPos, / / máximo rolagem posiçãoBOOLbRedraw / / 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 o intervalo de um controle de barra de rolagem. O parâmetro de hWnd deve ser o identificador para o Controlarar de barra de rolagem.
SB_HORZ Define o intervalo de barra de rolagem horizontal padrão da janela.
SB_VERT Define o intervalo de barra de rolagem vertical padrão da janela.

nMinPos
Especifica o mínimo rolagem posição.
nMaxPos
Especifica o máximo rolagem posição.
bRedraw
Especifica se o barra de rolagem deve ser redesenhada para refletir a alteração. 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 é diferente de zero.

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

Observações

Você pode usar SetScrollRange para ocultar a barra de rolagem por configuração nMinPos e nMaxPos para o mesmo valor. Um aplicativo não deve chamar o SetScrollRange função para ocultar uma barra de rolagem ao processar uma mensagem de barra de rolagem. Novos aplicativos devem usar a função ShowScrollBar para ocultar a barra de rolagem.

Se a chamar para SetScrollRange imediatamente segue uma chamada para o SetScrollPos função, o bRedraw parâmetro no SetScrollPos deve ser zero para impedir que a barra de rolagem sendo desenhada duas vezes.

O intervalo padrão para uma barra de rolagem padrão é 0 a 100. O intervalo padrão para um Controlarar de barra de rolagem é vazio (o nMinPos e nMaxPos valores de parâmetro são zero). A diferença entre os valores especificados pelo nMinPos e nMaxPos parâmetros não deve ser maior que o valor de MAXLONG.

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 nMaxPos parâmetro o SetScrollRange 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, SetScrollPos, ShowScrollBar

Index