ProgressBar.Increment(Int32) Méthode

Définition

Fait avancer la position actuelle de la barre de progression de la quantité spécifiée.Advances the current position of the progress bar by the specified amount.

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

Paramètres

value
Int32

Quantité d'incrémentation de la position actuelle de la barre de progression.The amount by which to increment the progress bar's current position.

Exceptions

La propriété Style a la valeur Marquee.The Style property is set to Marquee

Exemples

L’exemple de code suivant montre comment utiliser la méthode Increment et la propriété Value pour incrémenter la valeur d’un ProgressBar dans l’événement Tick d’un Timer.The following code example demonstrates how to use the Increment method and the Value property to increment the value of a ProgressBar in the Tick event of a Timer. L’exemple affiche également la propriété Value dans un StatusBarPanel pour fournir une représentation textuelle de l' ProgressBar.The example also displays the Value property in a StatusBarPanel to provide a textual representation of the ProgressBar. Cet exemple nécessite que vous disposiez d’un contrôle ProgressBar, nommé progressBar1et d’un contrôle StatusBar qui contient une StatusBarPanel, nommée statusBarPanel1.This example requires that you have a ProgressBar control, named progressBar1, and a StatusBar control that contains a StatusBarPanel, named statusBarPanel1. Le Timer, nommé time, doit être ajouté au formulaire en tant que membre.The Timer, named time, must be added to the form as a member.

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

Remarques

La méthode Increment vous permet d’incrémenter la valeur de la barre de progression d’une quantité spécifique.The Increment method enables you to increment the value of the progress bar by a specific amount. Cette méthode d’incrémentation de la barre de progression est semblable à l’utilisation de la propriété Step avec la méthode PerformStep.This method of incrementing the progress bar is similar to using the Step property with the PerformStep method. La propriété Value spécifie la position actuelle du ProgressBar.The Value property specifies the current position of the ProgressBar. Si, après avoir appelé la méthode Increment, la propriété Value est supérieure à la valeur de la propriété Maximum, la propriété Value reste à la valeur de la propriété Maximum.If, after calling the Increment method, the Value property is greater than the value of the Maximum property, the Value property remains at the value of the Maximum property. Si, après avoir appelé la méthode Increment avec une valeur négative spécifiée dans le paramètre value, la propriété Value est inférieure à la valeur de la propriété Minimum, la propriété Value reste à la valeur de la propriété Minimum.If, after calling the Increment method with a negative value specified in the value parameter, the Value property is less than the value of the Minimum property, the Value property remains at the value of the Minimum property.

Comme un objet ProgressBar dont le style est défini sur Marquee affiche une barre de défilement continue au lieu de son Value, l’appel de Increment n’est pas nécessaire et lève une InvalidOperationException.Because a ProgressBar object whose style is set to Marquee displays a continuously scrolling bar instead of its Value, calling Increment is unnecessary and will raise an InvalidOperationException.

S’applique à

Voir aussi