ProgressBar.Value ProgressBar.Value ProgressBar.Value ProgressBar.Value Property

Definizione

Ottiene o imposta la posizione corrente dell'indicatore di stato.Gets or sets the current position of the progress bar.

public:
 property int Value { int get(); void set(int value); };
[System.ComponentModel.Bindable(true)]
public int Value { get; set; }
member this.Value : int with get, set
Public Property Value As Integer

Valore della proprietà

Posizione nell'intervallo dell'indicatore di stato.The position within the range of the progress bar. Il valore predefinito è 0.The default is 0.

Eccezioni

Il valore specificato è maggiore del valore della proprietà Maximum.The value specified is greater than the value of the Maximum property.

In alternativa-or- Il valore specificato è minore del valore della proprietà Minimum.The value specified is less than the value of the Minimum property.

Esempi

Nell'esempio di codice riportato di seguito viene illustrato Increment come utilizzare il Value metodo e la proprietà per incrementare ProgressBar il Tick valore di un oggetto Timernell'evento di un oggetto.The following code example demonstrates how to use the Increment method and the Value property to increment the value of a ProgressBar in the Tick event of a Timer. Nell'esempio viene inoltre visualizzata Value la proprietà in StatusBarPanel un oggetto per fornire ProgressBaruna rappresentazione testuale di.The example also displays the Value property in a StatusBarPanel to provide a textual representation of the ProgressBar. Per questo esempio è necessario disporre di ProgressBar un controllo, progressBar1denominato, e StatusBar di un controllo che StatusBarPanelcontiene un statusBarPanel1oggetto, denominato.This example requires that you have a ProgressBar control, named progressBar1, and a StatusBar control that contains a StatusBarPanel, named statusBarPanel1. L' Timeroggetto, timedenominato, deve essere aggiunto al form come membro.The Timer, named time, must be added to the form as a member.

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à sono specificati Minimum dalle proprietà e Maximum .The minimum and maximum values of the Value property are specified by the Minimum and Maximum properties. Questa proprietà consente di incrementare o decrementare direttamente il valore dell'indicatore di stato.This property enables you to increment or decrement the value of the progress bar directly. Per eseguire un aumento coerente del valore del ProgressBar controllo, è possibile usare la Step proprietà con il PerformStep metodo.To perform consistent increases in the value of the ProgressBar control you can use the Step property with the PerformStep method. Per aumentare il valore dell'indicatore di stato variando gli importi, utilizzare il Increment metodo.To increase the progress bar value by varying amounts, use the Increment method.

Si applica a

Vedi anche