Freigeben über


Übersicht über das ProgressBar-Steuerelement (Windows Forms)

Von Bedeutung

Das ToolStripProgressBar-Steuerelement ersetzt und fügt dem ProgressBar-Steuerelement Funktionen hinzu; Das ProgressBar-Steuerelement wird jedoch sowohl für die Abwärtskompatibilität als auch für die zukünftige Verwendung beibehalten, wenn Sie dies auswählen.

Das Windows Forms-ProgressBar-Steuerelement gibt den Fortschritt eines Prozesses an, indem eine entsprechende Anzahl von Rechtecks angezeigt wird, die in einer horizontalen Leiste angeordnet sind. Wenn der Vorgang abgeschlossen ist, ist die Leiste gefüllt. Statusanzeigen werden häufig verwendet, um dem Benutzer eine Vorstellung davon zu geben, wie lange auf den Abschluss eines Prozesses gewartet wird. Zum Beispiel, wenn eine große Datei geladen wird.

Hinweis

Das ProgressBar-Steuerelement kann nur horizontal auf dem Formular ausgerichtet werden.

Wichtige Eigenschaften und Methoden

Die wichtigsten Eigenschaften des ProgressBar-Steuerelements sind Value, Minimum und Maximum. Die Eigenschaften Minimum und Maximum legen die Maximal- und Mindestwerte fest, die der Fortschrittsbalken anzeigen kann. Die Value-Eigenschaft stellt den Fortschritt dar, der hinsichtlich der Fertigstellung des Vorgangs erzielt wurde. Da die im Steuerelement angezeigte Leiste aus Blöcken besteht, entspricht der vom ProgressBar-Steuerelement angezeigte Wert nur annähernd dem aktuellen Wert der Value-Eigenschaft. Anhand der Größe des ProgressBar-Steuerelements bestimmt die Value-Eigenschaft, wann der nächste Block angezeigt wird.

Die am häufigsten verwendete Methode, um den aktuellen Fortschrittswert zu aktualisieren, besteht darin, Code zu schreiben, der die Value-Eigenschaft festlegt. Im Beispiel zum Laden einer großen Datei können Sie die maximale Größe der Datei in Kilobyte festlegen. Wenn die Maximum-Eigenschaft beispielsweise auf 100 festgelegt ist, wird die Minimum-Eigenschaft auf 10 festgelegt, und die Value-Eigenschaft wird auf 50 festgelegt, 5 Rechtecke werden angezeigt. Dies ist die Hälfte der Zahl, die angezeigt werden kann.

Es gibt jedoch noch andere Möglichkeiten, den vom ProgressBar-Steuerelement angezeigten Wert zu ändern, abgesehen vom direkten Festlegen der Value-Eigenschaft. Die Step-Eigenschaft kann verwendet werden, um einen Wert anzugeben, um den die Value-Eigenschaft erhöht wird. Anschließend erhöht das Aufrufen der PerformStep-Methode den Wert. Um den Inkrementwert zu variieren, können Sie die Increment-Methode verwenden und einen Wert angeben, mit dem die Value-Eigenschaft erhöht werden soll.

Ein weiteres Steuerelement, das den Benutzer grafisch über eine aktuelle Aktion informiert, ist das StatusBar-Steuerelement.

Von Bedeutung

Die Steuerelemente StatusStrip und ToolStripStatusLabel ersetzen und fügen den Steuerelementen StatusBar und StatusBarPanel Funktionen hinzu; Die Steuerelemente StatusBar und StatusBarPanel werden jedoch sowohl für die Abwärtskompatibilität als auch für die zukünftige Verwendung beibehalten, wenn Sie dies auswählen.

Siehe auch