ProgressBar.Maximum Proprietà

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origine:

ProgressBar.cs

Ottiene o imposta il valore massimo dell'intervallo del controllo.

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

Valore della proprietà

Int32

Valore massimo dell'intervallo. Il valore predefinito è 100.

Eccezioni

ArgumentException

Il valore specificato è minore di 0.

Esempio

Nell'esempio di codice seguente viene utilizzato un ProgressBar controllo per visualizzare lo stato di avanzamento di un'operazione di copia file. Nell'esempio vengono utilizzate le Minimum proprietà e Maximum per specificare un intervallo per l'oggetto ProgressBar equivalente al numero di file da copiare. Il codice usa anche la Step proprietà con il PerformStep metodo per incrementare il valore di ProgressBar come file viene copiato. In questo esempio è necessario che sia stato creato un ProgressBar controllo denominato pBar1 creato all'interno di e Form che sia stato creato un metodo denominato CopyFile (che restituisce un valore booleano che indica che l'operazione di copia file è stata completata correttamente) che esegue l'operazione di copia file. Il codice richiede inoltre che venga creata e passata una matrice di stringhe contenenti i file da copiare al CopyWithProgress metodo definito nell'esempio e che il metodo venga chiamato da un altro metodo o evento in 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 ] ))
         {
            // 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]))
        {
            // 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

Commenti

Questa proprietà specifica il limite superiore della Value proprietà. Quando il valore della Maximum proprietà viene modificato, il ProgressBar controllo viene ridisegnato per riflettere il nuovo intervallo del controllo. Quando il valore della Value proprietà è uguale al valore della Maximum proprietà, l'indicatore di stato viene riempito completamente.

È possibile utilizzare questa proprietà per specificare un valore a cui impostare la Value proprietà (impostando la Value proprietà o utilizzando i Increment metodi o PerformStep ) per indicare che un'operazione è stata completata. Ad esempio, è possibile impostare il valore della Maximum proprietà sul numero totale di file in un'operazione di copia file. Ogni volta che un file viene copiato, la Value proprietà può essere aumentata di 1 fino a quando non viene copiato il numero totale di file. A quel punto, l'indicatore di stato sarebbe completamente riempito.

Vedi anche

• Minimum
• Value