ProgressBar.Increment(Int32) Methode

public:
 void Increment(int value);

public void Increment(int value);

member this.Increment : int -> unit

Public Sub Increment (value As Integer)

Parameters

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de Increment methode en de Value eigenschap gebruikt om de waarde van een ProgressBar in het Tick geval van een Timer. In het voorbeeld wordt ook de Value eigenschap in een StatusBarPanel weergegeven om een tekstuele weergave van de ProgressBar. Voor dit voorbeeld is vereist dat u een ProgressBar besturingselement met de naam progressBar1en een StatusBar besturingselement hebt dat een StatusBarPanelbenoemd besturingselement statusBarPanel1bevat. De Timernaam , timemoet als lid aan het formulier worden toegevoegd.

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

Opmerkingen

Met Increment de methode kunt u de waarde van de voortgangsbalk verhogen met een bepaald bedrag. Deze methode voor het verhogen van de voortgangsbalk is vergelijkbaar met het gebruik van de Step eigenschap met de PerformStep methode. De Value eigenschap geeft de huidige positie van de ProgressBar. Als de Value eigenschap na het aanroepen van de Increment methode groter is dan de waarde van de Maximum eigenschap, blijft de Value eigenschap op de waarde van de Maximum eigenschap. Als na het aanroepen van de Increment methode met een negatieve waarde die is opgegeven in de value parameter, de Value eigenschap kleiner is dan de waarde van de Minimum eigenschap, blijft de Value eigenschap op de waarde van de Minimum eigenschap.

Omdat een ProgressBar object waarvan de stijl is ingesteld om Marquee een continu schuivende balk weer te geven in plaats van Valuede balk, is aanroepen Increment niet nodig en wordt een InvalidOperationException.

Zie ook

• Maximum
• Minimum
• Value
• Step
• PerformStep()