ProgressBar.Increment(Int32) Methode

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

InvalidOperationException

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: