ProgressBar.Maximum Propriété

Définition

Obtient ou définit la valeur maximale de la plage du contrôle.Gets or sets the maximum value of the range of the control.

public:
 property int Maximum { int get(); void set(int value); };
public int Maximum { get; set; }
member this.Maximum : int with get, set
Public Property Maximum As Integer

Valeur de propriété

Valeur maximale de la plage.The maximum value of the range. La valeur par défaut est 100.The default is 100.

Exceptions

La valeur spécifiée est inférieure à 0.The value specified is less than 0.

Exemples

L’exemple de code suivant utilise un contrôle ProgressBar pour afficher la progression d’une opération de copie de fichier.The following code example uses a ProgressBar control to display the progress of a file copy operation. L’exemple utilise les propriétés Minimum et Maximum pour spécifier une plage pour le ProgressBar équivalent au nombre de fichiers à copier.The example uses the Minimum and Maximum properties to specify a range for the ProgressBar that is equivalent to the number of files to copy. Le code utilise également la propriété Step avec la méthode PerformStep pour incrémenter la valeur de la ProgressBar lors de la copie d’un fichier.The code also uses the Step property with the PerformStep method to increment the value of the ProgressBar as a file is copied. Dans cet exemple, vous avez créé un contrôle ProgressBar nommé pBar1 créé dans un Form et une méthode appelée CopyFile (qui retourne une valeur booléenne indiquant que l’opération de copie de fichier a été effectuée avec succès) qui effectue l’opération de copie de fichiers.This example requires that you have a ProgressBar control created called pBar1 that is created within a Form and that there is a method created called CopyFile (that returns a Boolean value indicating the file copy operation was completed successfully) that performs the file copy operation. Le code requiert également qu’un tableau de chaînes contenant les fichiers à copier soit créé et passé à la méthode CopyWithProgress définie dans l’exemple et que la méthode soit appelée à partir d’une autre méthode ou d’un autre événement dans le Form.The code also requires that an array of strings containing the files to copy is created and passed to the CopyWithProgress method defined in the example and that the method is called from another method or event in the Form.

private:
   void CopyWithProgress( array<String^>^filenames )
   {
      // Display the ProgressBar control.
      pBar1->Visible = true;

      // Set Minimum to 1 to represent the first file being copied.
      pBar1->Minimum = 1;

      // Set Maximum to the total number of files to copy.
      pBar1->Maximum = filenames->Length;

      // Set the initial value of the ProgressBar.
      pBar1->Value = 1;

      // Set the Step property to a value of 1 to represent each file being copied.
      pBar1->Step = 1;

      // Loop through all files to copy.
      for ( int x = 1; x <= filenames->Length; x++ )
      {
         // Copy the file and increment the ProgressBar if successful.
         if ( CopyFile( filenames[ x - 1 ] ) == true )
         {
            // Perform the increment on the ProgressBar.
            pBar1->PerformStep();
         }
      }
   }
private void CopyWithProgress(string[] filenames)
{
    // Display the ProgressBar control.
    pBar1.Visible = true;
    // Set Minimum to 1 to represent the first file being copied.
    pBar1.Minimum = 1;
    // Set Maximum to the total number of files to copy.
    pBar1.Maximum = filenames.Length;
    // Set the initial value of the ProgressBar.
    pBar1.Value = 1;
    // Set the Step property to a value of 1 to represent each file being copied.
    pBar1.Step = 1;
    
    // Loop through all files to copy.
    for (int x = 1; x <= filenames.Length; x++)
    {
        // Copy the file and increment the ProgressBar if successful.
        if(CopyFile(filenames[x-1]) == true)
        {
            // Perform the increment on the ProgressBar.
            pBar1.PerformStep();
        }
    }
}
Private Sub CopyWithProgress(ByVal ParamArray filenames As String())
    ' Display the ProgressBar control.
    pBar1.Visible = True
    ' Set Minimum to 1 to represent the first file being copied.
    pBar1.Minimum = 1
    ' Set Maximum to the total number of files to copy.
    pBar1.Maximum = filenames.Length
    ' Set the initial value of the ProgressBar.
    pBar1.Value = 1
    ' Set the Step property to a value of 1 to represent each file being copied.
    pBar1.Step = 1

    ' Loop through all files to copy.
    Dim x As Integer
    for x = 1 To filenames.Length - 1
        ' Copy the file and increment the ProgressBar if successful.
        If CopyFile(filenames(x - 1)) = True Then
            ' Perform the increment on the ProgressBar.
            pBar1.PerformStep()
        End If
    Next x
End Sub

Remarques

Cette propriété spécifie la limite supérieure de la propriété Value.This property specifies the upper limit of the Value property. Lorsque la valeur de la propriété Maximum est modifiée, le contrôle ProgressBar est redessiné pour refléter la nouvelle plage du contrôle.When the value of the Maximum property is changed, the ProgressBar control is redrawn to reflect the new range of the control. Lorsque la valeur de la propriété Value est égale à la valeur de la propriété Maximum, la barre de progression est entièrement remplie.When the value of the Value property is equal to the value of the Maximum property, the progress bar is completely filled.

Vous pouvez utiliser cette propriété pour spécifier une valeur à laquelle la propriété Value doit être définie (en définissant la propriété Value ou à l’aide des méthodes Increment ou PerformStep) pour indiquer qu’une opération est terminée.You can use this property to specify a value to which the Value property must be set (by setting the Value property or using the Increment or PerformStep methods) to indicate that an operation is complete. Par exemple, vous pouvez définir la valeur de la propriété Maximum sur le nombre total de fichiers dans une opération de copie de fichier.For example, you can set the value of the Maximum property to the total number of files in a file copy operation. Chaque fois qu’un fichier est copié, la propriété Value peut être augmentée de 1 jusqu’à ce que le nombre total de fichiers soit copié.Each time a file is copied, the Value property can be increased by 1 until the total number of files is copied. À ce stade, la barre de progression est entièrement remplie.At that point, the progress bar would be completely filled.

S’applique à

Voir aussi