Compartilhar via

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

  • Artigo

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

Os HScrollBar controles (horizontal) e (vertical) operam independentemente de outros controles e têm seu próprio conjunto de eventos, propriedades e VScrollBar 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 TextBox controle tem uma ScrollBars propriedade para mostrar ou ocultar barras de rolagem anexadas ao controle).

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

Propriedade Value

A Value propriedade (que, por padrão, é 0) é um integer valor correspondente à posição da caixa de rolagem na barra de rolagem. Quando a posição da caixa de rolagem é o valor mínimo, ela se move para a posição mais à esquerda (para barras de rolagem horizontais) ou a posição superior (para barras de rolagem verticais). Quando a caixa de rolagem está no valor máximo, ela se move para a posição mais à direita ou para a posição inferior. Da mesma forma, um valor entre a parte inferior e superior do intervalo coloca a borda esquerda 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 Minimum propriedades para Maximum definidas pelo usuário.

Propriedades de SmallChange e LargeChange

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 Value propriedade muda de acordo com o valor definido na LargeChange propriedade.

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

Confira também