ProgressBar.Maximum Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define o valor máximo do intervalo do controle.

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

Valor da propriedade

Int32

O valor máximo do intervalo. O padrão é 100.

Exceções

ArgumentException

O valor especificado é menor que 0.

Exemplos

O exemplo de código a seguir usa um ProgressBar controle para exibir o progresso de uma operação de cópia de arquivo. O exemplo usa e as Minimum Maximum propriedades para especificar um intervalo para o ProgressBar que é equivalente ao número de arquivos a serem copiados. O código também usa a Step propriedade com o PerformStep método para incrementar o valor do ProgressBar arquivo como um arquivo é copiado. Este exemplo exige que você tenha um ProgressBar controle criado chamado pBar1 que é criado dentro de um Form e que há um método criado chamado CopyFile (que retorna um valor booliano que indica que a operação de cópia de arquivo foi concluída com êxito) que executa a operação de cópia de arquivo. O código também exige que uma matriz de cadeias de caracteres contendo os arquivos a serem copiados seja criada e passada para o CopyWithProgress método definido no exemplo e que o método seja chamado de outro método ou evento no 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

Comentários

Essa propriedade especifica o limite superior da Value propriedade. Quando o valor da Maximum propriedade é alterado, o ProgressBar controle é redesenhado para refletir o novo intervalo do controle. Quando o valor da Value propriedade é igual ao valor da propriedade, a barra de Maximum progresso é completamente preenchida.

Você pode usar essa propriedade para especificar um valor ao qual a Value propriedade deve ser definida (definindo a Value propriedade ou usando os PerformStep Increment métodos) para indicar que uma operação está concluída. Por exemplo, você pode definir o valor da Maximum propriedade como o número total de arquivos em uma operação de cópia de arquivo. Cada vez que um arquivo é copiado, a Value propriedade pode ser aumentada em 1 até que o número total de arquivos seja copiado. Nesse ponto, a barra de progresso seria completamente preenchida.

Confira também

• Minimum
• Value