Freigeben über

ProgressBar.PerformStep Methode

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Erhöht die aktuelle Position der Statusanzeige um den Betrag der Step-Eigenschaft.

public:
 void PerformStep();
public void PerformStep ();
member this.PerformStep : unit -> unit
Public Sub PerformStep ()

Ausnahmen

InvalidOperationException

Für Style ist Marquee festgelegt.

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

Die PerformStep Methode erhöht den Wert der Statusleiste um den durch die Step Eigenschaft angegebenen Betrag. Mit der Step Eigenschaft können Sie den Betrag angeben, den jede abgeschlossene Aufgabe in einem Vorgang den Wert der Statusleiste ändert. Wenn Sie beispielsweise eine Gruppe von Dateien kopieren, sollten 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 durch den Wert der Step Eigenschaft zu erhöhen. Wenn Sie flexiblere Kontrolle über den Wert der Statusleiste haben möchten, können Sie die Increment Methode verwenden oder den Wert der Value Eigenschaft direkt festlegen.

Die Value Eigenschaft gibt die aktuelle Position der ProgressBar. Wenn die Eigenschaft nach dem Aufrufen der PerformStep Methode größer als der Wert der Maximum Eigenschaft ist, bleibt die Value Value Eigenschaft beim Wert der Maximum Eigenschaft. Wenn die Methode nach dem Aufrufen der PerformStep Methode mit einem negativen Wert, der in Stepder Eigenschaft angegeben ist, Value kleiner als der Wert der Minimum Eigenschaft ist, bleibt die Value Eigenschaft am Wert der Minimum Eigenschaft.

Da ein ProgressBar Objekt, dessen Format so festgelegt ist, dass Marquee eine fortlaufende Bildlaufleiste anstelle dessen Valueangezeigt wird, ist das Aufrufen PerformStep unnötig und löst eine Aushebung aus InvalidOperationException.

Gilt für

Siehe auch