Partilhar via

Visão geral dos controles HScrollBar e VScrollBar (Windows Forms)

  • Artigo

Os controles ScrollBar Windows Forms são usados para fornecer navegação fácil através de uma longa lista de itens ou uma grande quantidade de informações rolando horizontal ou verticalmente dentro de um aplicativo ou controle. As barras de rolagem são um elemento comum da interface do Windows, portanto, o controle ScrollBar é freqüentemente usado com controles que não derivam da classe ScrollableControl. Da mesma forma, muitos desenvolvedores optam por incorporar o controle ScrollBar ao criar seus próprios controles de usuário.

Os controles HScrollBar (horizontal) e VScrollBar (vertical) operam independentemente de outros controles e têm seu próprio conjunto de eventos, propriedades e métodos. ScrollBar controles não são iguais às barras de rolagem internas anexadas a caixas de texto, caixas de listagem, caixas de combinação ou formulários MDI (o controle TextBox tem uma propriedade ScrollBars para mostrar ou ocultar barras de rolagem anexadas ao controle).

Os controles ScrollBar usam o evento Scroll para monitorar o movimento da caixa de rolagem (às vezes chamado de polegar) ao longo da barra de rolagem. O uso do evento Scroll fornece acesso ao valor da barra de rolagem à medida que ele está sendo arrastado.

Propriedade Valor

A propriedade Value (que, por padrão, é 0) é um valor de integer correspondente à posição da caixa de rolagem na barra de rolagem. Quando a posição da caixa de rolagem está no valor mínimo, ela se move para a posição mais à esquerda (para barras de rolagem horizontais) ou para a posição superior (para barras de rolagem verticais). Quando a caixa de rolagem está no valor máximo, a caixa de rolagem se move para a posição mais à direita ou inferior. Da mesma forma, um valor a meio caminho entre o limite inferior e superior do intervalo coloca a extremidade frontal da caixa de rolagem no meio da barra de rolagem.

Além de usar cliques do mouse para alterar o valor da barra de rolagem, um usuário também pode arrastar a caixa de rolagem para qualquer ponto ao longo da barra. O valor resultante depende da posição da caixa de rolagem, mas está sempre dentro do intervalo das propriedades de Minimum a Maximum definidas pelo usuário.

Propriedades LargeChange e SmallChange

Quando o usuário pressiona a tecla PAGE UP ou PAGE DOWN ou clica na faixa da barra de rolagem em ambos os lados da caixa de rolagem, a propriedade Value muda de acordo com o valor definido na propriedade LargeChange.

Quando o usuário pressiona uma das teclas de seta ou clica em um dos botões da barra de rolagem, a propriedade Value muda de acordo com o valor definido na propriedade SmallChange.

Ver também