Visão geral do controle ProgressBar (Windows Forms)

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 windows forms ProgressBar indica o progresso de um processo exibindo um número apropriado de retângulos organizados em uma barra horizontal. Quando o processo é concluído, a barra é 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.

Observação

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

Principais propriedades e métodos

As principais propriedades do ProgressBar controle são Value, Minimume Maximum. O Minimum e Maximum são as propriedades que definem os valores máximo e mínimo que a barra de progresso pode exibir. A Value propriedade 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 apenas se aproxima do valor atual da propriedade Value. Com base no tamanho do ProgressBar controle, a Value propriedade determina quando exibir o próximo bloco.

A maneira mais comum de atualizar o valor de progresso atual é escrever código para definir a Value propriedade. 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 Maximum propriedade estiver definida como 100, a Minimum propriedade será definida como 10 e a Value propriedade 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 ProgressBar controle, além de definir a Value propriedade diretamente. A Step propriedade pode ser usada para especificar um valor para incrementar a Value propriedade. Em seguida, chamar o PerformStep método incrementará o valor. Para variar o valor de incremento, você pode usar o Increment método e especificar um valor com o qual incrementar a Value propriedade.

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

Importante

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

Consulte também

• ProgressBar
• Controle ProgressBar