ProgressBar.Value Propriedade

Definição

Obtém ou define a posição atual da barra de progresso.

[System.ComponentModel.Bindable(true)]
public int Value { get; set; }

Valor da propriedade

A posição dentro do intervalo da barra de progresso. O padrão é 0.

Atributos

Exceções

O valor especificado é maior que o valor da propriedade Maximum.

- ou -

O valor especificado é menor que o valor da propriedade Minimum.

Exemplos

O exemplo de código a seguir demonstra como usar o Increment método e a Value propriedade para incrementar o valor de um ProgressBar no caso de um Timer.Tick O exemplo também exibe a Value propriedade em um StatusBarPanel para fornecer uma representação textual do ProgressBar. Este exemplo exige que você tenha um ProgressBar controle, chamado progressBar1e um StatusBar controle que contém um StatusBarPanel, chamado statusBarPanel1. O Timer, chamado time, deve ser adicionado ao formulário como um membro.

private Timer time = new Timer();

// Call this method from the constructor of the form.
private void InitializeMyTimer()
{
   // Set the interval for the timer.
   time.Interval = 250;
   // Connect the Tick event of the timer to its event handler.
   time.Tick += new EventHandler(IncreaseProgressBar);
   // Start the timer.
   time.Start();
}

private void IncreaseProgressBar(object sender, EventArgs e)
{
   // Increment the value of the ProgressBar a value of one each time.
   progressBar1.Increment(1);
   // Display the textual value of the ProgressBar in the StatusBar control's first panel.
   statusBarPanel1.Text = progressBar1.Value.ToString() + "% Completed";
   // Determine if we have completed by comparing the value of the Value property to the Maximum value.
   if (progressBar1.Value == progressBar1.Maximum)
      // Stop the timer.
      time.Stop();
}

Comentários

Os valores mínimo e máximo da Value propriedade são especificados pelas Minimum propriedades e Maximum . Essa propriedade permite incrementar ou diminuir o valor da barra de progresso diretamente. Para executar aumentos consistentes no valor do ProgressBar controle, você pode usar a Step propriedade com o PerformStep método . Para aumentar o valor da barra de progresso em quantidades variadas, use o Increment método .

Aplica-se a

Produto Versões
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

Confira também