ProgressBar.Maximum ProgressBar.Maximum ProgressBar.Maximum ProgressBar.Maximum Property

Definizione

Ottiene o imposta il valore massimo dell'intervallo del controllo.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

Valore della proprietà

Valore massimo dell'intervallo.The maximum value of the range. Il valore predefinito è 100.The default is 100.

Eccezioni

Il valore specificato è minore di 0.The value specified is less than 0.

Esempi

Nell'esempio di codice seguente viene ProgressBar usato un controllo per visualizzare lo stato di avanzamento di un'operazione di copia file.The following code example uses a ProgressBar control to display the progress of a file copy operation. Nell'esempio vengono utilizzate Minimum le Maximum proprietà e per specificare un intervallo per ProgressBar l'equivalente al numero di file da copiare.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. Il codice usa anche la Step proprietà con il PerformStep metodo per ProgressBar incrementare il valore di durante la copia di un file.The code also uses the Step property with the PerformStep method to increment the value of the ProgressBar as a file is copied. Questo esempio richiede che sia stato creato ProgressBar un controllo denominato pBar1 creato all'interno di un Form oggetto e che sia presente un metodo denominato CopyFile (che restituisce un valore booleano che indica che l'operazione di copia del file è stata completato correttamente) che esegue l'operazione di copia del file.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. Il codice richiede inoltre che una matrice di stringhe contenente i file da copiare venga creata e passata al CopyWithProgress metodo definito nell'esempio e che il metodo venga chiamato da un altro metodo o evento Formin.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

Commenti

Questa proprietà specifica il limite superiore della Value proprietà.This property specifies the upper limit of the Value property. Quando viene modificato il valore Maximum della proprietà, il ProgressBar controllo viene ridisegnato per riflettere il nuovo intervallo del controllo.When the value of the Maximum property is changed, the ProgressBar control is redrawn to reflect the new range of the control. Quando il valore della Value proprietà è uguale al valore Maximum della proprietà, l'indicatore di stato viene riempito completamente.When the value of the Value property is equal to the value of the Maximum property, the progress bar is completely filled.

È possibile utilizzare questa proprietà per specificare un valore al quale è Value necessario impostare la proprietà (impostando la Value proprietà o utilizzando i Increment metodi PerformStep o) per indicare che un'operazione è stata completata.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. Ad esempio, è possibile impostare il valore della Maximum proprietà sul numero totale di file in un'operazione di copia file.For example, you can set the value of the Maximum property to the total number of files in a file copy operation. Ogni volta che viene copiato un file, Value la proprietà può essere aumentata di 1 fino a quando non viene copiato il numero totale di file.Each time a file is copied, the Value property can be increased by 1 until the total number of files is copied. A questo punto, l'indicatore di stato verrebbe riempito completamente.At that point, the progress bar would be completely filled.

Si applica a

Vedi anche