ProgressBar.Value Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ottiene o imposta la posizione corrente della barra di stato.

public:
 property int Value { int get(); void set(int value); };

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

[<System.ComponentModel.Bindable(true)>]
member this.Value : int with get, set

Public Property Value As Integer

Valore della proprietà

Int32

Posizione nell'intervallo della barra di stato. Il valore predefinito è 0.

Attributi

BindableAttribute

Eccezioni

ArgumentException

Il valore specificato è maggiore del valore della proprietà Maximum.

-oppure-

Il valore specificato è minore del valore della proprietà Minimum.

Esempio

Nell'esempio di codice seguente viene illustrato come utilizzare il Increment metodo e la Value proprietà per incrementare il valore di un ProgressBar oggetto in Tick caso di un oggetto Timer. Nell'esempio viene inoltre visualizzata la Value proprietà in per StatusBarPanel fornire una rappresentazione testuale dell'oggetto ProgressBar. In questo esempio è necessario disporre di un ProgressBar controllo denominato progressBar1e di un StatusBar controllo che contiene un StatusBarPaneloggetto , denominato statusBarPanel1. Il Timer, denominato time, deve essere aggiunto al form come membro.

private:
   Timer^ time;

   // Call this method from the constructor of the form.
   void InitializeMyTimer()
   {
      // Set the interval for the timer.
      time->Interval = 250;

      // Connect the Tick event of the timer to its event handler.
      time->Tick += gcnew EventHandler( this, &Form1::IncreaseProgressBar );

      // Start the timer.
      time->Start();
   }

   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 = String::Concat( progressBar1->Value, "% 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();
   }

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();
}

Private time As New Timer()

' Call this method from the constructor of the form.
Private Sub InitializeMyTimer()
   ' Set the interval for the timer.
   time.Interval = 250
   ' Connect the Tick event of the timer to its event handler.
   AddHandler time.Tick, AddressOf IncreaseProgressBar
   ' Start the timer.
   time.Start()
End Sub


Private Sub IncreaseProgressBar(ByVal sender As Object, ByVal e As EventArgs)
   ' 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 Then
      ' Stop the timer.
      time.Stop()
   End If
End Sub

Commenti

I valori minimo e massimo della Value proprietà vengono specificati dalle Minimum proprietà e Maximum . Questa proprietà consente di incrementare o decrementare direttamente il valore dell'indicatore di stato. Per eseguire aumenti coerenti nel valore del ProgressBar controllo, è possibile usare la Step proprietà con il PerformStep metodo . Per aumentare il valore dell'indicatore di stato in base a quantità variabili, utilizzare il Increment metodo .

Vedi anche

• Maximum
• Minimum