Freigeben über


ProgressBar.Minimum Eigenschaft

Definition

Ruft den Mindestwert des Bereichs des Steuerelements ab oder legt diesen fest.

public:
 property int Minimum { int get(); void set(int value); };
public int Minimum { get; set; }
member this.Minimum : int with get, set
Public Property Minimum As Integer

Eigenschaftswert

Int32

Der Mindestwert des Bereichs. Die Standardeinstellung ist 0.

Ausnahmen

Der für die Eigenschaft angegebene Wert ist kleiner als 0 (null).

Beispiele

Im folgenden Codebeispiel wird ein ProgressBar Steuerelement verwendet, um den Fortschritt eines Dateikopievorgangs anzuzeigen. Im Beispiel werden die und Maximum die Minimum Eigenschaften verwendet, um einen Bereich für den ProgressBar Bereich anzugeben, der der Anzahl der zu kopierenden Dateien entspricht. Der Code verwendet auch die Eigenschaft mit der Step PerformStep Methode, um den Wert der ProgressBar Datei zu erhöhen. In diesem Beispiel muss ein ProgressBar Steuerelement erstellt werden, das innerhalb eines FormSteuerelements erstellt pBar1 wurde, und dass eine Methode erstellt CopyFile wird (die einen booleschen Wert zurückgibt, der den Dateikopievorgang angibt, wurde erfolgreich abgeschlossen), der den Dateikopievorgang ausführt. Der Code erfordert außerdem, 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 in der .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

Hinweise

Diese Eigenschaft gibt die untere Grenze der Value Eigenschaft an. Wenn der Wert der Minimum 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 Minimum Eigenschaft ist, ist die Statusleiste leer. Um den Wert der Statusleiste zu ändern, verwenden Sie die Step Eigenschaft mit der PerformStep Methode, verwenden Sie die Increment Methode, oder legen Sie den Wert der Value Eigenschaft direkt fest.

Gilt für

Siehe auch