ProgressBar.Maximum Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft den Höchstwert des Bereichs des Steuerelements ab oder legt diesen fest.

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

Eigenschaftswert

Int32

Der Höchstwert des Bereichs. Der Standardwert ist 100.

Ausnahmen

ArgumentException

Der angegebene Wert ist kleiner als 0 (null).

Beispiele

Im folgenden Codebeispiel wird ein ProgressBar -Steuerelement verwendet, um den Fortschritt eines Dateikopiervorgangs anzuzeigen. Im Beispiel werden die Minimum Eigenschaften und Maximum verwendet, um einen Bereich für das anzugeben, der ProgressBar der Anzahl der zu kopierenden Dateien entspricht. Der Code verwendet auch die Step -Eigenschaft mit der PerformStep -Methode, um den Wert von zu erhöhen, ProgressBar während eine Datei kopiert wird. In diesem Beispiel muss ein ProgressBar Steuerelement mit dem Namen pBar1 erstellt werden, das in einem Form erstellt wird, und dass eine Methode mit dem Namen CopyFile erstellt wird (die einen booleschen Wert zurückgibt, der angibt, dass der Dateikopiervorgang erfolgreich abgeschlossen wurde), die den Dateikopiervorgang ausführt. Der Code erfordert auch, dass ein Array von Zeichenfolgen, die die zu kopierenden Dateien enthalten, erstellt und an die CopyWithProgress im Beispiel definierte Methode übergeben wird, und dass die Methode von einer anderen Methode oder einem anderen Ereignis im Formaufgerufen wird.

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

Hinweise

Diese Eigenschaft gibt die Obergrenze der Value Eigenschaft an. Wenn der Wert der Maximum -Eigenschaft geändert wird, wird das ProgressBar Steuerelement neu gezeichnet, um den neuen Bereich des Steuerelements widerzuspiegeln. Wenn der Wert der Value Eigenschaft gleich dem Wert der Maximum Eigenschaft ist, wird die Statusanzeige vollständig ausgefüllt.

Sie können diese Eigenschaft verwenden, um einen Wert anzugeben, auf den die Value Eigenschaft festgelegt werden muss (indem Sie die Value -Eigenschaft festlegen oder die Increment -Methode oder PerformStep verwenden), um anzugeben, dass ein Vorgang abgeschlossen ist. Beispielsweise können Sie den Wert der Maximum -Eigenschaft auf die Gesamtanzahl der Dateien in einem Dateikopiervorgang festlegen. Jedes Mal, wenn eine Datei kopiert wird, kann die Value Eigenschaft um 1 erhöht werden, bis die Gesamtzahl der Dateien kopiert wird. An diesem Punkt wäre die Statusanzeige vollständig gefüllt.

Weitere Informationen

• Minimum
• Value