QProgressBar Class
Das QProgressBar-Widget stellt einen horizontalen oder vertikalen Fortschrittsbalken bereit. Mehr...
| Überschrift: | #include <QProgressBar> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | 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 |
Neu implementierte ö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 |
Neu implementierte geschützte Funktionen
| virtual bool | event(QEvent *e) override |
| virtual void | paintEvent(QPaintEvent *) override |
Ausführliche Beschreibung
Ein Fortschrittsbalken dient dazu, dem Benutzer einen Hinweis auf den Fortschritt eines Vorgangs zu geben und ihm zu versichern, dass die Anwendung noch läuft.
Der Fortschrittsbalken basiert auf dem Konzept von Schritten. Sie richten ihn ein, indem Sie den minimalen und maximalen möglichen Schrittwert angeben. Wenn Sie ihm später den aktuellen Schrittwert übermitteln, zeigt er den Prozentsatz der bereits abgeschlossenen Schritte an. Der Prozentsatz wird berechnet, indem der Fortschritt (value() – minimum()) durch maximum() – minimum() dividiert wird.
Sie können die minimale und maximale Schrittanzahl mit ` setMinimum()` und ` setMaximum` festlegen. Die aktuelle Schrittanzahl wird mit ` setValue()` gesetzt. Der Fortschrittsbalken kann mit ` reset()` auf den Anfang zurückgesetzt werden.
Wenn sowohl der Mindest- als auch der Höchstwert auf 0 gesetzt sind, zeigt der Balken anstelle eines prozentualen Fortschritts eine „Beschäftigt“-Anzeige an. Dies ist beispielsweise nützlich, wenn mit ` QNetworkAccessManager ` Elemente heruntergeladen werden, bei denen die Größe des heruntergeladenen Elements nicht bestimmt werden kann.
Siehe auch QProgressDialog.
Dokumentation zu Mitgliedstypen
enum QProgressBar::Direction
Legt die Leserichtung des „ text “ für vertikale Fortschrittsbalken fest.
| 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. |
Beachten Sie, dass es vom Stil abhängt, ob der Text gezeichnet wird oder nicht. Derzeit zeichnen die Stile „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 legt die Ausrichtung des Fortschrittsbalkens fest
Zugriffsfunktionen:
| Qt::Alignment | alignment() const |
| void | setAlignment(Qt::Alignment alignment) |
format : QString
Diese Eigenschaft enthält die Zeichenfolge, die zur Generierung des aktuellen Textes verwendet wird
%p – wird durch den Fertigstellungsgrad ersetzt. %v – wird durch den aktuellen Wert ersetzt. %m – wird durch die Gesamtzahl der Schritte ersetzt.
Der Standardwert lautet „%p%“.
Zugriffsfunktionen:
| QString | format() const |
| void | setFormat(const QString &format) |
| void | resetFormat() |
Siehe auch text().
invertedAppearance : bool
Diese Eigenschaft legt fest, ob ein Fortschrittsbalken den Fortschritt umgekehrt anzeigt oder nicht
Wenn diese Eigenschaft auf „ true “ gesetzt ist, wächst der Fortschrittsbalken in die entgegengesetzte Richtung (z. B. von rechts nach links). Standardmäßig ist der Fortschrittsbalken nicht umgekehrt.
Zugriffsfunktionen:
| bool | invertedAppearance() const |
| void | setInvertedAppearance(bool invert) |
Siehe auch „ orientation “ und „ layoutDirection “.
maximum : int
Diese Eigenschaft enthält den Maximalwert des Fortschrittsbalkens
Beim Festlegen dieser Eigenschaft wird der „ minimum “ bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt. Liegt der aktuelle Wert außerhalb des neuen Bereichs, wird der Fortschrittsbalken mit „ reset()“ zurückgesetzt.
Zugriffsfunktionen:
| int | maximum() const |
| void | setMaximum(int maximum) |
minimum : int
Diese Eigenschaft enthält den Mindestwert des Fortschrittsbalkens
Beim Festlegen dieser Eigenschaft wird der „ maximum “ bei Bedarf angepasst, um sicherzustellen, dass der Bereich gültig bleibt. Liegt der aktuelle Wert außerhalb des neuen Bereichs, 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 entweder „ Qt::Horizontal “ (Standard) oder „ Qt::Vertical “ lauten.
Zugriffsfunktionen:
| Qt::Orientation | orientation() const |
| void | setOrientation(Qt::Orientation) |
Siehe auch „ invertedAppearance “ und „ textDirection “.
[read-only] text : QString
Diese Eigenschaft enthält den beschreibenden Text, der zusammen mit dem Fortschrittsbalken angezeigt wird
Der zurückgegebene Text entspricht dem Text, der in der Mitte (oder bei einigen Stilen links) des Fortschrittsbalkens angezeigt wird.
Der im Text angezeigte Fortschritt kann kleiner als der Mindestwert sein, was darauf hinweist, dass sich der Fortschrittsbalken im „Zurücksetz“-Zustand befindet, bevor ein Fortschritt festgelegt wurde.
In der Standardimplementierung enthält der Text entweder einen Prozentwert, der den bisherigen Fortschritt angibt, oder er ist leer, da sich der Fortschrittsbalken im „Reset“-Zustand befindet.
Zugriffsfunktionen:
| virtual QString | text() const |
textDirection : Direction
Diese Eigenschaft legt die Leserichtung des „ text “ für vertikale Fortschrittsbalken fest
Diese Eigenschaft hat keine Auswirkungen auf horizontale Fortschrittsbalken. Standardmäßig ist die Lesrichtung „ QProgressBar::TopToBottom “.
Zugriffsfunktionen:
| QProgressBar::Direction | textDirection() const |
| void | setTextDirection(QProgressBar::Direction textDirection) |
Siehe auch „ orientation “ und „ textVisible “.
textVisible : bool
Diese Eigenschaft legt fest, ob der aktuelle Fertigstellungsgrad angezeigt werden soll
Diese Eigenschaft kann vom Stil ignoriert werden (z. B. zeichnet QMacStyle den Text niemals).
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 Minimal-Maximal-Bereichs zu ändern, hat keine Auswirkung auf den aktuellen Wert.
Zugriffsfunktionen:
| int | value() const |
| void | setValue(int value) |
Benachrichtigungssignal:
| void | valueChanged(int value) |
Dokumentation der Member-Funktionen
[explicit] QProgressBar::QProgressBar(QWidget *parent = nullptr)
Erstellt 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()
Destruktor.
[override virtual protected] bool QProgressBar::event(QEvent *e)
Umsetzt: ` QWidget::event(QEvent *event)`.
[virtual protected] void QProgressBar::initStyleOption(QStyleOptionProgressBar *option) const
Initialisieren Sie ` option ` mit den Werten aus dieser Datei: QProgressBar. Diese Methode ist für Unterklassen nützlich, wenn diese ein ` QStyleOptionProgressBar` benötigen, aber nicht alle Informationen selbst eingeben möchten.
Siehe auch ` QStyleOption::initFrom()`.
[override virtual] QSize QProgressBar::minimumSizeHint() const
Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::minimumSizeHint “ neu.
[override virtual protected] void QProgressBar::paintEvent(QPaintEvent *)
Umsetzt: ` QWidget::paintEvent` (`QPaintEvent *event`).
[slot] void QProgressBar::reset()
Den Fortschrittsbalken zurücksetzen. Der Fortschrittsbalken „spult zurück“ und zeigt keinen Fortschritt an.
[slot] void QProgressBar::setRange(int minimum, int maximum)
Legt den Minimal- und Maximalwert des Fortschrittsbalkens auf minimum bzw. maximum fest.
Ist maximum kleiner als minimum, ist minimum der einzige zulässige Wert.
Liegt der aktuelle Wert außerhalb des neuen Bereichs, wird der Fortschrittsbalken mit ` reset()` zurückgesetzt.
Der QProgressBar kann mithilfe von setRange(0, 0) in einen unbestimmten Zustand versetzt werden.
Siehe auch „ minimum “ und „ maximum “.
[override virtual] QSize QProgressBar::sizeHint() const
Implementiert eine Zugriffsfunktion für die Eigenschaft „ QWidget::sizeHint “ neu.
[signal] void QProgressBar::valueChanged(int value)
Dieses Signal wird ausgelöst, wenn sich der in der Fortschrittsanzeige angezeigte Wert ändert. „ value “ ist der neue Wert, der in der Fortschrittsanzeige angezeigt wird.
Hinweis: Notifier -Signal für die Eigenschaft „ value “.
© 2026 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.
