ProgressBar.PerformStep Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Wechselt die aktuelle Position der Statusanzeige um die Höhe der Step Eigenschaft.
public:
void PerformStep();public void PerformStep();member this.PerformStep : unit -> unitPublic Sub PerformStep ()Ausnahmen
Beispiele
Im folgenden Codebeispiel wird ein ProgressBar Steuerelement verwendet, um den Fortschritt eines Dateikopievorgangs anzuzeigen. Im Beispiel werden der Bereich und Maximum die Minimum Eigenschaften verwendet, um einen Bereich anzugeben, der ProgressBar der Anzahl der zu kopierenden Dateien entspricht. Der Code verwendet auch die Step Eigenschaft mit der PerformStep Methode, um den Wert der ProgressBar datei zu erhöhen. Dieses Beispiel erfordert, dass Sie ein ProgressBar Steuerelement erstellt haben, das in pBar1 einer FormErstellt wird, und dass eine Methode erstellt wird CopyFile (die einen booleschen Wert zurückgibt, der angibt, dass der Dateikopievorgang erfolgreich abgeschlossen wurde), die 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 ] ))
{
// 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]))
{
// 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, in dem jeder abgeschlossene Vorgang 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 Statusanzeige um 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 Value Eigenschaft nach dem Aufrufen der PerformStep Methode größer als der Wert der Maximum Eigenschaft ist, verbleibt die Value Eigenschaft am Wert der Maximum Eigenschaft. Wenn 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, verbleibt die Value Eigenschaft am Wert der Minimum Eigenschaft.
Da ein ProgressBar Objekt, dessen Format so festgelegt Marquee ist, dass eine fortlaufende Bildlaufleiste anstelle des ValueObjekts angezeigt wird, ist das Aufrufen PerformStep unnötig und löst eine InvalidOperationException.
