ProgressBar.Increment-Methode

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Sub Increment ( _
    value As Integer _
)
'Usage
Dim instance As ProgressBar
Dim value As Integer

instance.Increment(value)

public void Increment (
    int value
)

public:
void Increment (
    int value
)

public void Increment (
    int value
)

public function Increment (
    value : int
)

Parameter

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

Ausnahmen

Hinweise

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

Beispiel

Das folgende Codebeispiel veranschaulicht, wie Sie mit der Increment-Methode und der Value-Eigenschaft den Wert einer ProgressBar im Tick-Ereignis von Timer schrittweise erhöhen können. Im Beispiel wird auch die Value-Eigenschaft in einem StatusBarPanel angezeigt, um eine Textdarstellung der ProgressBar bereitzustellen. Für dieses Beispiel ist es erforderlich, dass ein ProgressBar-Steuerelement mit dem Namen progressBar1 sowie ein StatusBar-Steuerelement mit einem StatusBarPanel und dem Namen statusBarPanel1 vorhanden sind. Der Timer mit dem Namen time muss dem Formular als Member hinzugefügt werden.

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

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:
   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.set_Interval(250);
    // Connect the Tick event of the timer to its event handler.
    time.add_Tick(new EventHandler(IncreaseProgressBar));
    // Start the timer.
    time.Start();
} //InitializeMyTimer

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.set_Text(progressBar1.get_Value() + "% Completed");
    // Determine if we have completed by comparing the value of the Value
    // property to the Maximum value.
    if (progressBar1.get_Value() == progressBar1.get_Maximum()) {
        // Stop the timer.
        time.Stop();
    }        
} //IncreaseProgressBar

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ProgressBar-Klasse
ProgressBar-Member
System.Windows.Forms-Namespace
Maximum
Minimum
Value
Step
PerformStep