ProgressBar.Increment(Int32) Metod

public:
 void Increment(int value);

public void Increment(int value);

member this.Increment : int -> unit

Public Sub Increment (value As Integer)

Parametrar

Undantag

Exempel

Följande kodexempel visar hur du använder Increment metoden och Value egenskapen för att öka värdet för en ProgressBar i Tick händelse av en Timer. Exemplet visar Value även egenskapen i en StatusBarPanel för att ge en textrepresentation av ProgressBar. Det här exemplet kräver att du har en ProgressBar kontroll med namnet progressBar1, och en StatusBar kontroll som innehåller en StatusBarPanel, med namnet statusBarPanel1. , Timermed namnet time, måste läggas till i formuläret som medlem.

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

Kommentarer

Med Increment metoden kan du öka värdet för förloppsindikatorn med en viss mängd. Den här metoden för att öka förloppsindikatorn liknar att använda Step egenskapen med PerformStep -metoden. Egenskapen Value anger den aktuella positionen för ProgressBar. Om egenskapen efter att ha anropat Increment metoden Value är större än värdet för Maximum egenskapen förblir Value egenskapen värdet för Maximum egenskapen. Om egenskapen efter att ha anropat Increment metoden med ett negativt värde som anges i parametern valueValue är mindre än värdet Minimum för egenskapen, Value förblir egenskapen värdet för Minimum egenskapen.

Eftersom ett ProgressBar objekt vars formatmall är inställd på att Marquee visa en löpande rullningslist i stället för dess Value, är anropet Increment onödigt och genererar en InvalidOperationException.

Se även

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