ProgressBar.Step Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft den Betrag ab, um den die PerformStep()-Methode die aktuelle Position der Statusanzeige erhöht, oder legt diesen fest.

public:
 property int Step { int get(); void set(int value); };

public int Step { get; set; }

member this.Step : int with get, set

Public Property Step As Integer

Eigenschaftswert

Int32

Der Betrag, um den die Statusanzeige bei jedem Aufruf der PerformStep()-Methode erhöht werden soll. Der Standardwert ist 10.

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 ProgressBar zu erhöhen, als eine Datei kopiert wird. Dieses Beispiel erfordert, dass Sie ein ProgressBar Steuerelement mit dem Namen pBar1 erstellt haben, das in einem Formerstellt wird, und dass es eine Methode mit dem Namen CopyFile gibt (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 in 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

Sie können die Step -Eigenschaft verwenden, um den Betrag anzugeben, in dem jede abgeschlossene Aufgabe in einem Vorgang den Wert der Statusleiste ändert. Wenn Sie beispielsweise eine Gruppe von Dateien kopieren, können Sie den Wert der Step Eigenschaft auf 1 und den Wert der Maximum Eigenschaft auf die Gesamtzahl der zu kopierenden Dateien festlegen. Wenn jede Datei kopiert wird, können Sie die PerformStep -Methode aufrufen, um die Statusleiste um den Wert der Step -Eigenschaft zu erhöhen. Wenn Sie den Wert der Statusleiste flexibler steuern möchten, können Sie die Increment -Methode verwenden oder den Wert der Value Eigenschaft direkt festlegen.

Weitere Informationen

• PerformStep()
• Value
• Increment(Int32)