ProgressBar.Value Eigenschaft

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

Eigenschaftswert

Die Position innerhalb des Bereichs der Statusanzeige. Der Standardwert lautet 0.

Attribute

BindableAttribute

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Increment Methode und die Value Eigenschaft verwendet werden, um den Wert eines ProgressBar Inkrements für ein Tick Ereignis Timerzu erhöhen. Das Beispiel zeigt auch die Value Eigenschaft in einer StatusBarPanel , um eine textbezogene Darstellung der ProgressBar. In diesem Beispiel müssen Sie über ein ProgressBar Steuerelement, einen Namen progressBar1und ein StatusBar Steuerelement verfügen, das einen StatusBarPanel, benannten Namen statusBarPanel1enthält. Der TimerBenannte timemuss dem Formular als Mitglied hinzugefügt werden.

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

Hinweise

Die Mindest- und Höchstwerte der Value Eigenschaft werden durch die Minimum Eigenschaften und Maximum Eigenschaften angegeben. Mit dieser Eigenschaft können Sie den Wert der Statusleiste direkt erhöhen oder verringern. Um konsistente Erhöhungen des Werts des ProgressBar Steuerelements durchzuführen, können Sie die Step Eigenschaft mit der PerformStep Methode verwenden. Verwenden Sie die Increment Methode, um den Fortschrittsbalkenwert um unterschiedliche Beträge zu erhöhen.

Weitere Informationen

• Maximum
• Minimum