Compartilhar via

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

Os controles ScrollBar do Windows Forms são usados para fornecer navegação fácil por meio de uma longa lista de itens ou uma grande quantidade de informações rolando horizontal ou verticalmente dentro de um aplicativo ou controle. Barras de rolagem são um elemento comum da interface do Windows, portanto, o controle ScrollBar geralmente é 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 (horizontais) e VScrollBar (verticais) operam independentemente de outros controles e têm seu próprio conjunto de eventos, propriedades e métodos. Os controles ScrollBar não são os mesmos que as barras de rolagem internas anexadas às caixas de texto, caixas de listagem, caixas de combinação ou formulários MDI (o controle TextBox tem uma propriedade ScrollBars para exibir 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 conhecida como o polegar) ao longo da barra de rolagem. Usar o evento Scroll fornece acesso ao valor da barra de rolagem enquanto ela é arrastada.

Propriedade Value

A propriedade Value (que, por padrão, é 0) é um valor 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 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 propriedades Minimum a 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 propriedade Value é alterada de acordo com o valor definido na propriedade LargeChange.

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

Consulte também

  • Last updated on