QProgressBar Class
Das QProgressBar-Widget bietet einen horizontalen oder vertikalen Fortschrittsbalken. Mehr...
| Kopfzeile: | #include <QProgressBar> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Vererbungen: | QWidget |
Öffentliche Typen
| enum | Direction { TopToBottom, BottomToTop } |
Eigenschaften
|
|
Öffentliche Funktionen
| QProgressBar(QWidget *parent = nullptr) | |
| virtual | ~QProgressBar() |
| Qt::Alignment | alignment() const |
| QString | format() const |
| bool | invertedAppearance() const |
| bool | isTextVisible() const |
| int | maximum() const |
| int | minimum() const |
| Qt::Orientation | orientation() const |
| void | resetFormat() |
| void | setAlignment(Qt::Alignment alignment) |
| void | setFormat(const QString &format) |
| void | setInvertedAppearance(bool invert) |
| void | setTextDirection(QProgressBar::Direction textDirection) |
| void | setTextVisible(bool visible) |
| virtual QString | text() const |
| QProgressBar::Direction | textDirection() const |
| int | value() const |
Reimplementierte öffentliche Funktionen
| virtual QSize | minimumSizeHint() const override |
| virtual QSize | sizeHint() const override |
Öffentliche Slots
| void | reset() |
| void | setMaximum(int maximum) |
| void | setMinimum(int minimum) |
| void | setOrientation(Qt::Orientation) |
| void | setRange(int minimum, int maximum) |
| void | setValue(int value) |
Signale
| void | valueChanged(int value) |
Geschützte Funktionen
| virtual void | initStyleOption(QStyleOptionProgressBar *option) const |
Reimplementierte geschützte Funktionen
| virtual bool | event(QEvent *e) override |
| virtual void | paintEvent(QPaintEvent *) override |
Detaillierte Beschreibung
Ein Fortschrittsbalken wird verwendet, um dem Benutzer einen Hinweis auf den Fortschritt einer Operation zu geben und ihm zu versichern, dass die Anwendung noch läuft.
Der Fortschrittsbalken verwendet das Konzept der Schritte. Sie richten ihn ein, indem Sie die minimal und maximal möglichen Schrittwerte angeben, und er zeigt den Prozentsatz der abgeschlossenen Schritte an, wenn Sie ihm später den aktuellen Schrittwert geben. Der Prozentsatz wird berechnet, indem der Fortschritt (value() - minimum()) durch maximum() - minimum() geteilt wird.
Die minimale und maximale Schrittzahl können Sie mit setMinimum() und setMaximum festlegen. Die aktuelle Anzahl der Schritte wird mit setValue() eingestellt. Der Fortschrittsbalken kann mit reset() an den Anfang zurückgespult werden.
Wenn Minimum und Maximum beide auf 0 gesetzt sind, zeigt der Balken anstelle der prozentualen Schrittanzahl eine Besetztanzeige. Dies ist z. B. nützlich, wenn QNetworkAccessManager zum Herunterladen von Elementen verwendet wird und die Größe des heruntergeladenen Elements nicht ermittelt werden kann.
Siehe auch QProgressDialog.
Dokumentation der Mitgliedstypen
enum QProgressBar::Direction
Gibt die Leserichtung der text für vertikale Fortschrittsbalken an.
| Konstante | Wert | Beschreibung |
|---|---|---|
QProgressBar::TopToBottom | 0 | Der Text wird um 90 Grad im Uhrzeigersinn gedreht. |
QProgressBar::BottomToTop | 1 | Der Text wird um 90 Grad gegen den Uhrzeigersinn gedreht. |
Ob der Text gezeichnet wird oder nicht, hängt vom Stil ab. Derzeit zeichnen CleanLooks und Plastique den Text. Die Stile Mac, Windows und WindowsVista tun dies nicht.
Siehe auch textDirection.
Dokumentation der Eigenschaft
alignment : Qt::Alignment
Diese Eigenschaft bestimmt die Ausrichtung des Fortschrittsbalkens
Zugriffsfunktionen:
| Qt::Alignment | alignment() const |
| void | setAlignment(Qt::Alignment alignment) |
format : QString
Diese Eigenschaft enthält die Zeichenkette, die zur Erstellung des aktuellen Textes verwendet wird
%p - wird durch den abgeschlossenen Prozentsatz ersetzt. %v - wird durch den aktuellen Wert ersetzt. %m - wird durch die Gesamtzahl der Schritte ersetzt.
Der Standardwert ist "%p%".
Zugriffsfunktionen:
| QString | format() const |
| void | setFormat(const QString &format) |
| void | resetFormat() |
Siehe auch text().
invertedAppearance : bool
Diese Eigenschaft legt fest, ob ein Fortschrittsbalken seinen Fortschritt invertiert anzeigt oder nicht
Wenn diese Eigenschaft true lautet, wächst der Fortschrittsbalken in die andere Richtung (z. B. von rechts nach links). Standardmäßig ist der Fortschrittsbalken nicht invertiert.
Zugriffsfunktionen:
| bool | invertedAppearance() const |
| void | setInvertedAppearance(bool invert) |
Siehe auch orientation und layoutDirection.
maximum : int
Diese Eigenschaft enthält den Maximalwert des Fortschrittsbalkens
Beim Setzen dieser Eigenschaft wird die minimum gegebenenfalls angepasst, um sicherzustellen, dass der Bereich gültig bleibt. Wenn der aktuelle Wert außerhalb des neuen Bereichs liegt, wird der Fortschrittsbalken mit reset() zurückgesetzt.
Zugriffsfunktionen:
| int | maximum() const |
| void | setMaximum(int maximum) |
minimum : int
Diese Eigenschaft enthält den Mindestwert für den Fortschrittsbalken.
Beim Setzen dieser Eigenschaft wird die maximum gegebenenfalls angepasst, um sicherzustellen, dass der Bereich gültig bleibt. Wenn der aktuelle Wert außerhalb des neuen Bereichs liegt, wird der Fortschrittsbalken mit reset() zurückgesetzt.
Zugriffsfunktionen:
| int | minimum() const |
| void | setMinimum(int minimum) |
orientation : Qt::Orientation
Diese Eigenschaft gibt die Ausrichtung des Fortschrittsbalkens an
Die Ausrichtung muss Qt::Horizontal (Standard) oder Qt::Vertical sein.
Zugriffsfunktionen:
| Qt::Orientation | orientation() const |
| void | setOrientation(Qt::Orientation) |
Siehe auch invertedAppearance und textDirection.
[read-only] text : const QString
Diese Eigenschaft enthält den beschreibenden Text, der mit dem Fortschrittsbalken angezeigt wird.
Der zurückgegebene Text ist derselbe wie der Text, der in der Mitte (oder in einigen Stilen links) des Fortschrittsbalkens angezeigt wird.
Der im Text angezeigte Fortschritt kann kleiner als der Mindestwert sein, was anzeigt, dass sich der Fortschrittsbalken im "Reset"-Zustand befindet, bevor ein Fortschritt festgelegt wird.
In der Standardimplementierung enthält der Text entweder einen Prozentwert, der den bisherigen Fortschritt anzeigt, oder er ist leer, da sich der Fortschrittsbalken im Reset-Zustand befindet.
Zugriffsfunktionen:
| virtual QString | text() const |
textDirection : Direction
Diese Eigenschaft legt die Leserichtung der text für vertikale Fortschrittsbalken fest.
Diese Eigenschaft hat keine Auswirkung auf horizontale Fortschrittsbalken. Standardmäßig ist die Leserichtung QProgressBar::TopToBottom.
Zugriffsfunktionen:
| QProgressBar::Direction | textDirection() const |
| void | setTextDirection(QProgressBar::Direction textDirection) |
Siehe auch orientation und textVisible.
textVisible : bool
Diese Eigenschaft gibt an, ob der aktuelle Fertigstellungsgrad angezeigt werden soll.
Diese Eigenschaft kann vom Stil ignoriert werden (z.B. zeichnet QMacStyle den Text nie).
Zugriffsfunktionen:
| bool | isTextVisible() const |
| void | setTextVisible(bool visible) |
Siehe auch textDirection.
value : int
Diese Eigenschaft enthält den aktuellen Wert des Fortschrittsbalkens
Der Versuch, den aktuellen Wert auf einen Wert außerhalb des Minimum-Maximum-Bereichs zu ändern, hat keine Auswirkungen auf den aktuellen Wert.
Zugriffsfunktionen:
| int | value() const |
| void | setValue(int value) |
Benachrichtigungssignal:
| void | valueChanged(int value) |
Dokumentation der Mitgliedsfunktionen
[explicit] QProgressBar::QProgressBar(QWidget *parent = nullptr)
Konstruiert einen Fortschrittsbalken mit dem angegebenen parent.
Standardmäßig ist der minimale Schrittwert auf 0 und der maximale auf 100 gesetzt.
Siehe auch setRange().
[virtual noexcept] QProgressBar::~QProgressBar()
Zerstörer.
[override virtual protected] bool QProgressBar::event(QEvent *e)
Reimplements: QWidget::event(QEvent *Event).
[virtual protected] void QProgressBar::initStyleOption(QStyleOptionProgressBar *option) const
Initialisieren Sie option mit den Werten aus dieser QProgressBar. Diese Methode ist nützlich für Unterklassen, wenn sie eine QStyleOptionProgressBar benötigen, aber nicht alle Informationen selbst eingeben wollen.
Siehe auch QStyleOption::initFrom().
[override virtual] QSize QProgressBar::minimumSizeHint() const
Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QWidget::minimumSizeHint.
[override virtual protected] void QProgressBar::paintEvent(QPaintEvent *)
Reimplements: QWidget::paintEvent(QPaintEvent *event).
[slot] void QProgressBar::reset()
Setzen Sie den Fortschrittsbalken zurück. Der Fortschrittsbalken "spult zurück" und zeigt keinen Fortschritt an.
[slot] void QProgressBar::setRange(int minimum, int maximum)
Setzt den Mindest- und Höchstwert des Fortschrittsbalkens auf minimum bzw. maximum.
Wenn maximum kleiner als minimum ist, wird minimum zum einzig zulässigen Wert.
Wenn der aktuelle Wert außerhalb des neuen Bereichs liegt, wird der Fortschrittsbalken mit reset() zurückgesetzt.
QProgressBar kann mit setRange(0, 0) in den unbestimmten Zustand versetzt werden.
Siehe auch minimum und maximum.
[override virtual] QSize QProgressBar::sizeHint() const
Reimplantiert eine Zugriffsfunktion für die Eigenschaft: QWidget::sizeHint.
[signal] void QProgressBar::valueChanged(int value)
Dieses Signal wird ausgegeben, wenn sich der in der Fortschrittsleiste angezeigte Wert ändert. value ist der neue Wert, der in der Fortschrittsleiste angezeigt wird.
Hinweis: Benachrichtigungssignal für die Eigenschaft value.
© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
