ProgressBar.Minimum Propriété

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtient ou définit la valeur minimale du contrôle d'entrée associé.

public:
 property int Minimum { int get(); void set(int value); };

public int Minimum { get; set; }

member this.Minimum : int with get, set

Public Property Minimum As Integer

Valeur de propriété

Int32

Valeur minimale de la plage. La valeur par défaut est 0.

Exceptions

ArgumentException

La valeur spécifiée pour la propriété 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 fichier. L’exemple utilise les propriétés et Maximum les Minimum propriétés pour spécifier une plage correspondant ProgressBar au nombre de fichiers à copier. Le code utilise également la propriété avec la Step PerformStep méthode pour incrémenter la valeur du ProgressBar fichier en tant que fichier copié. Cet exemple nécessite que vous ayez un ProgressBar contrôle créé 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é terminée avec succès) qui effectue l’opération de copie de fichier. Le code nécessite également qu’un tableau de chaînes contenant les fichiers à copier soit créé et transmis à 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 événement dans l’exemple 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 inférieure de la Value propriété. Lorsque la valeur de la Minimum 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 Minimum propriété, la barre de progression est vide. Pour modifier la valeur de la barre de progression, utilisez la Step propriété avec la PerformStep méthode, utilisez la Increment méthode ou définissez la valeur de la Value propriété directement.

Voir aussi

• Maximum
• Value