ProgressBar.Value Propriété

Définition

Obtient ou définit la position actuelle de la barre de progression.Gets or sets the current position of the progress bar.

public:
 property int Value { int get(); void set(int value); };
[System.ComponentModel.Bindable(true)]
public int Value { get; set; }
member this.Value : int with get, set
Public Property Value As Integer

Valeur de propriété

Position dans la plage de la barre de progression.The position within the range of the progress bar. La valeur par défaut est 0.The default is 0.

Attributs

Exceptions

La valeur spécifiée est supérieure à la valeur de la propriété Maximum.The value specified is greater than the value of the Maximum property.

- ou --or- La valeur spécifiée est inférieure à la valeur de la propriété Minimum.The value specified is less than the value of the Minimum property.

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 une StatusBarPanel pour fournir une représentation textuelle de la 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é progressBar1, et 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

Les valeurs minimale et maximale de la propriété Value sont spécifiées par les propriétés Minimum et Maximum.The minimum and maximum values of the Value property are specified by the Minimum and Maximum properties. Cette propriété vous permet d’incrémenter ou de décrémenter directement la valeur de la barre de progression.This property enables you to increment or decrement the value of the progress bar directly. Pour effectuer des augmentations cohérentes de la valeur du contrôle ProgressBar, vous pouvez utiliser la propriété Step avec la méthode PerformStep.To perform consistent increases in the value of the ProgressBar control you can use the Step property with the PerformStep method. Pour augmenter la valeur de la barre de progression en faisant varier les quantités, utilisez la méthode Increment.To increase the progress bar value by varying amounts, use the Increment method.

S’applique à

Voir aussi