ProgressBar.Value Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft die aktuelle Position der Statusanzeige ab oder legt diese fest.

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

Int32

Die Position innerhalb des Bereichs der Statusanzeige. Die Standardeinstellung ist 0.

Attribute

BindableAttribute

Ausnahmen

ArgumentException

Der angegebene Wert ist größer als der Wert der Maximum-Eigenschaft.

- oder -

Der angegebene Wert ist kleiner als der Wert der Minimum-Eigenschaft.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie die Increment -Methode und die Value -Eigenschaft verwendet werden, um den Wert eines ProgressBar im Tick -Ereignis von zu Timererhöhen. Im Beispiel wird auch die Value -Eigenschaft in einem StatusBarPanel angezeigt, um eine Textdarstellung des ProgressBarbereitzustellen. In diesem Beispiel müssen Sie über ein ProgressBar -Steuerelement mit dem Namen progressBar1und ein StatusBar -Steuerelement verfügen, das einen StatusBarPanelmit dem Namen statusBarPanel1enthält. Der Timermit dem Namen timemuss dem Formular als Member 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 minimalen und maximalen Werte der Value Eigenschaft werden durch die Minimum Eigenschaften und Maximum angegeben. Mit dieser Eigenschaft können Sie den Wert der Statusanzeige direkt inkrementieren 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 Increment die -Methode, um den Wert der Statusleiste um unterschiedliche Mengen zu erhöhen.

Weitere Informationen

• Maximum
• Minimum