Compartilhar via


Visão geral do controle ProgressBar (Windows Forms)

Observação importanteImportante

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

O Windows Forms ProgressBar controle indica o andamento de um processo, exibindo um número apropriado de retângulos organizados em uma barra horizontal Quando o processo estiver concluído, a barra é preenchida. Barras de progresso são usadas para dar ao usuário uma idéia de como longo para aguardar um processo seja concluído; Por exemplo, quando um arquivo grande está sendo carregado.

ObservaçãoObservação

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

Métodos e propriedades de chave

As propriedades-chave de ProgressBar controle são Value, Minimum, e Maximum. O Minimum e Maximum o máximo do conjunto de propriedades e valores de mínimos o progresso barra can de vídeo. O Value propriedade representa o progresso que fez em direção ao concluir a operação. Porque a barra exibida no controle é composta de blocos, o valor exibido pelo ProgressBar controle só se aproxima do Value valor atual. da propriedade Com base no tamanho da ProgressBar o controle, o Value propriedade determina quando exibir o próximo bloco.

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

No entanto, existem outras maneiras de modificar o valor exibido pelo ProgressBar controle, além da configuração do Value propriedade diretamente. O Step propriedade pode ser usada para especificar um valor para incrementar a Value propriedade por. Em seguida, chamar o PerformStep método incrementará o valor. Para variar o valor de incremento, você pode usar o Increment método e especifique um valor com o qual incrementar o Value propriedade.

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

Observação importanteImportante

O StatusStrip e ToolStripStatusLabel Substituir e adicionar funcionalidade para controles de StatusBar e StatusBarPanel controles; No entanto, o StatusBar e StatusBarPanel controles são mantidas para compatibilidade com versões anteriores e o uso futuro, se você escolher.

Consulte também

Referência

ProgressBar

Outros recursos

Controle ProgressBar (Windows Forms)