ProgressBar.Maximum Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit la valeur maximale de la plage du contrôle.

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é

Int32

Valeur maximale de la plage. La valeur par défaut est 100.

Exceptions

ArgumentException

La valeur spécifiée est inférieure à 0.

Exemples

L’exemple de code suivant utilise un ProgressBar contrôle pour afficher la progression d’une opération de copie de fichiers. L’exemple utilise les Minimum propriétés et Maximum pour spécifier une plage correspondant au ProgressBar nombre de fichiers à copier. Le code utilise également la Step propriété avec la PerformStep méthode pour incrémenter la valeur de car ProgressBar un fichier est copié. Cet exemple exige que vous ayez créé un ProgressBar contrôle appelé pBar1 qui est créé dans un Form et qu’il existe une méthode créée 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 fichier. Le code exige également qu’un tableau de chaînes contenant les fichiers à copier soit créé et passé à la CopyWithProgress méthode 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 .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 Value propriété. Lorsque la valeur de la Maximum propriété est modifiée, le ProgressBar contrôle est redessiné pour refléter la nouvelle plage du contrôle. Lorsque la valeur de la Value propriété est égale à la valeur de la Maximum propriété, la barre de progression est complètement remplie.

Vous pouvez utiliser cette propriété pour spécifier une valeur à laquelle la Value propriété doit être définie (en définissant la Value propriété ou en utilisant les Increment méthodes ou PerformStep ) pour indiquer qu’une opération est terminée. Par exemple, vous pouvez définir la valeur de la Maximum propriété sur le nombre total de fichiers dans une opération de copie de fichiers. Chaque fois qu’un fichier est copié, la Value propriété peut être augmentée de 1 jusqu’à ce que le nombre total de fichiers soit copié. À ce stade, la barre de progression est entièrement remplie.

Voir aussi

• Minimum
• Value