Compartilhar via

Visão geral do controle ProgressBar (Windows Forms)

  • Artigo

Importante

O controle ToolStripProgressBar substitui e adiciona funcionalidade ao controle ProgressBar; no entanto, o controle ProgressBar é mantido para compatibilidade com versões anteriores e uso futuro, se você escolher.

O controle ProgressBar do Windows Forms indica o progresso de um processo exibindo um número apropriado de retângulos organizados em uma barra horizontal. Quando o processo for concluído, a barra estará preenchida. As barras de progresso geralmente são usadas para dar ao usuário uma ideia de quanto tempo aguardar a conclusão de um processo; por exemplo, quando um arquivo grande está sendo carregado.

Nota

O controle ProgressBar só pode ser orientado horizontalmente no formulário.

Principais propriedades e métodos

As principais propriedades do controle ProgressBar são Value, Minimume Maximum. As propriedades Minimum e Maximum definem os valores máximo e mínimo que a barra de progresso pode exibir. A propriedade Value representa o progresso que foi feito para concluir a operação. Como a barra exibida no controle é composta por blocos, o valor exibido pelo controle ProgressBar só se aproxima do valor atual da propriedade Value. Com base no tamanho do controle ProgressBar, a propriedade Value determina quando exibir o próximo bloco.

A maneira mais comum de atualizar o valor de progresso atual é escrever código para definir a propriedade Value. No exemplo de carregamento de um arquivo grande, você pode definir o máximo para o tamanho do arquivo em quilobytes. Por exemplo, se a propriedade Maximum for definida como 100, a propriedade Minimum será definida como 10 e a propriedade Value será definida como 50, cinco retângulos serão exibidos. Isso é metade do número que pode ser exibido.

No entanto, há outras maneiras de modificar o valor exibido pelo controle ProgressBar, além de definir a propriedade Value diretamente. A propriedade Step pode ser usada para especificar um valor para incrementar a propriedade Value. Em seguida, chamar o método PerformStep incrementará o valor. Para variar o valor de incremento, você pode usar o método Increment e especificar um valor com o qual incrementar a propriedade Value.

Outro controle que informa graficamente o usuário sobre uma ação atual é o controle StatusBar.

Importante

Os controles StatusStrip e ToolStripStatusLabel substituem e adicionam funcionalidade aos controles StatusBar e StatusBarPanel; no entanto, os controles StatusBar e StatusBarPanel são mantidos para compatibilidade com versões anteriores e uso futuro, se você escolher.

Consulte também