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

Definición

Obtiene o establece el valor máximo del intervalo del control.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

Valor de propiedad

Valor máximo del intervalo.The maximum value of the range. El valor predeterminado es 100.The default is 100.

Excepciones

El valor especificado es menor que 0.The value specified is less than 0.

Ejemplos

En el ejemplo de código siguiente se usa un control ProgressBar para mostrar el progreso de una operación de copia de archivos.The following code example uses a ProgressBar control to display the progress of a file copy operation. En el ejemplo se usan las propiedades Minimum y Maximum para especificar un intervalo para el ProgressBar equivalente al número de archivos que se van a copiar.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. El código también usa la propiedad Step con el método PerformStep para incrementar el valor de ProgressBar a medida que se copia un archivo.The code also uses the Step property with the PerformStep method to increment the value of the ProgressBar as a file is copied. Este ejemplo requiere que se haya creado un control ProgressBar denominado pBar1 que se crea dentro de un @no__t 2 y que se ha creado un método denominado CopyFile (que devuelve un valor booleano que indica que la operación de copia de archivos se completó correctamente). realiza la operación de copia de archivos.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. El código también requiere que se cree una matriz de cadenas que contenga los archivos que se van a copiar y se pase al método CopyWithProgress definido en el ejemplo y que se llame al método desde otro método o evento del Form.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

Comentarios

Esta propiedad especifica el límite superior de la propiedad Value.This property specifies the upper limit of the Value property. Cuando se cambia el valor de la propiedad Maximum, el control ProgressBar vuelve a dibujarse para reflejar el nuevo intervalo del control.When the value of the Maximum property is changed, the ProgressBar control is redrawn to reflect the new range of the control. Cuando el valor de la propiedad Value es igual al valor de la propiedad Maximum, la barra de progreso se rellena completamente.When the value of the Value property is equal to the value of the Maximum property, the progress bar is completely filled.

Puede usar esta propiedad para especificar un valor al que se debe establecer la propiedad Value (estableciendo la propiedad Value o usando los métodos Increment o PerformStep) para indicar que se ha completado una operación.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. Por ejemplo, puede establecer el valor de la propiedad Maximum en el número total de archivos en una operación de copia de archivos.For example, you can set the value of the Maximum property to the total number of files in a file copy operation. Cada vez que se copia un archivo, la propiedad Value se puede aumentar en 1 hasta que se copie el número total de archivos.Each time a file is copied, the Value property can be increased by 1 until the total number of files is copied. En ese momento, la barra de progreso se rellenaría por completo.At that point, the progress bar would be completely filled.

Se aplica a

Consulte también: