Teilen über


ProgressBar.Increment(Int32) Methode

Definition

Erhöht die aktuelle Position der Statusanzeige um den angegebenen Betrag.

public:
 void Increment(int value);
public void Increment (int value);
member this.Increment : int -> unit
Public Sub Increment (value As Integer)

Parameter

value
Int32

Der Betrag, um den die aktuelle Position der Statusanzeige erhöht wird.

Ausnahmen

Die Style-Eigenschaft ist auf Marquee festgelegt.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie die Increment -Methode und die Value -Eigenschaft verwenden, um den Wert eines ProgressBar im Tick Fall eines Timerzu erhöhen. Im Beispiel wird auch die Value -Eigenschaft in einem StatusBarPanel angezeigt, um eine Textdarstellung von ProgressBarbereitzustellen. Dieses Beispiel erfordert, dass Sie über ein ProgressBar -Steuerelement mit dem Namen und progressBar1ein StatusBar -Steuerelement verfügen, das ein StatusBarPanel-Steuerelement mit dem Namen statusBarPanel1enthält. Der Timer, mit dem Namen time, muss 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

Mit Increment der -Methode können Sie den Wert der Statusleiste um einen bestimmten Betrag erhöhen. Diese Methode zum Erhöhen der Statusanzeige ähnelt der Verwendung der Step -Eigenschaft mit der PerformStep -Methode. Die Value -Eigenschaft gibt die aktuelle Position von an ProgressBar. Wenn die -Eigenschaft nach dem Aufrufen der Increment -Methode größer als der Wert der Maximum -Eigenschaft ist, bleibt die Value -Eigenschaft beim Wert der Maximum -Eigenschaft.Value Wenn die -Eigenschaft nach dem Aufrufen der Increment -Methode mit einem im value Parameter Value angegebenen negativen Wert kleiner als der Wert der Minimum -Eigenschaft ist, bleibt die Value -Eigenschaft beim Wert der Minimum -Eigenschaft.

Da ein ProgressBar -Objekt, dessen Stil auf eine fortlaufend scrollende Leiste anstelle des festgelegt Marquee ist, ist das ValueAufrufen Increment nicht erforderlich und löst einen aus InvalidOperationException.

Gilt für:

Weitere Informationen