QProgressBar Class
Le widget QProgressBar permet d'afficher une barre de progression horizontale ou verticale. En savoir plus...
| En-tête : | #include <QProgressBar> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Hérite de : | QWidget |
Types publics
| enum | Direction { TopToBottom, BottomToTop } |
Propriétés
|
|
Fonctions publiques
| 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 |
Fonctions publiques réimplémentées
| virtual QSize | minimumSizeHint() const override |
| virtual QSize | sizeHint() const override |
Slots publics
| void | reset() |
| void | setMaximum(int maximum) |
| void | setMinimum(int minimum) |
| void | setOrientation(Qt::Orientation) |
| void | setRange(int minimum, int maximum) |
| void | setValue(int value) |
Signaux
| void | valueChanged(int value) |
Fonctions protégées
| virtual void | initStyleOption(QStyleOptionProgressBar *option) const |
Fonctions protégées réimplémentées
| virtual bool | event(QEvent *e) override |
| virtual void | paintEvent(QPaintEvent *) override |
Description détaillée
Une barre de progression sert à indiquer à l'utilisateur l'avancement d'une opération et à le rassurer sur le fait que l'application est toujours en cours d'exécution.
La barre de progression repose sur le concept d’étapes. Vous la configurez en spécifiant les valeurs minimale et maximale possibles pour une étape ; elle affichera ensuite le pourcentage d’étapes déjà franchies lorsque vous lui fournirez la valeur actuelle de l’étape. Ce pourcentage est calculé en divisant la progression (value() - minimum()) par maximum() - minimum().
Vous pouvez spécifier le nombre minimum et maximum de pas à l’aide de setMinimum() et setMaximum. Le nombre actuel de pas est défini à l’aide de setValue(). La barre de progression peut être remise à zéro à l’aide de reset().
Si les valeurs minimale et maximale sont toutes deux définies sur 0, la barre affiche un indicateur « en cours » au lieu d’un pourcentage d’étapes. Cela s’avère utile, par exemple, lorsque l’on utilise QNetworkAccessManager pour télécharger des éléments dont la taille ne peut être déterminée.
Voir également QProgressDialog.
Documentation sur les types de membres
enum QProgressBar::Direction
Définit le sens de lecture de l'text e pour les barres de progression verticales.
| Constante | Valeur | Description |
|---|---|---|
QProgressBar::TopToBottom | 0 | Le texte est pivoté de 90 degrés dans le sens des aiguilles d'une montre. |
QProgressBar::BottomToTop | 1 | Le texte est pivoté de 90 degrés dans le sens inverse des aiguilles d'une montre. |
Notez que l'affichage ou non du texte dépend du style. Actuellement, les styles CleanLooks et Plastique affichent le texte. Les styles Mac, Windows et Windows Vista ne le font pas.
Voir aussi textDirection.
Documentation sur les propriétés
alignment : Qt::Alignment
Cette propriété définit l'alignement de la barre de progression
Fonctions d'accès :
| Qt::Alignment | alignment() const |
| void | setAlignment(Qt::Alignment alignment) |
format : QString
Cette propriété contient la chaîne de caractères utilisée pour générer le texte actuel
%p - est remplacé par le pourcentage d'avancement. %v - est remplacé par la valeur actuelle. %m - est remplacé par le nombre total d'étapes.
La valeur par défaut est « %p% ».
Fonctions d'accès :
| QString | format() const |
| void | setFormat(const QString &format) |
| void | resetFormat() |
Voir également text().
invertedAppearance : bool
Cette propriété détermine si la barre de progression affiche ou non sa progression dans le sens inverse
Si cette propriété est définie sur « true », la barre de progression s'allonge dans l'autre sens (par exemple, de droite à gauche). Par défaut, la barre de progression n'est pas inversée.
Fonctions d'accès :
| bool | invertedAppearance() const |
| void | setInvertedAppearance(bool invert) |
Voir également « orientation » et « layoutDirection ».
maximum : int
Cette propriété définit la valeur maximale de la barre de progression
Lors de la définition de cette propriété, la valeur « minimum » est ajustée si nécessaire afin de garantir que la plage reste valide. Si la valeur actuelle se situe en dehors de la nouvelle plage, la barre de progression est réinitialisée à l'aide de la fonction reset().
Fonctions d’accès :
| int | maximum() const |
| void | setMaximum(int maximum) |
minimum : int
Cette propriété définit la valeur minimale de la barre de progression
Lors de la définition de cette propriété, l'maximum est ajustée si nécessaire afin de garantir que la plage reste valide. Si la valeur actuelle se situe en dehors de la nouvelle plage, la barre de progression est réinitialisée à l'aide de la fonction reset().
Fonctions d'accès :
| int | minimum() const |
| void | setMinimum(int minimum) |
orientation : Qt::Orientation
Cette propriété définit l'orientation de la barre de progression
L'orientation doit être « Qt::Horizontal » (valeur par défaut) ou « Qt::Vertical ».
Fonctions d'accès :
| Qt::Orientation | orientation() const |
| void | setOrientation(Qt::Orientation) |
Voir également invertedAppearance et textDirection.
[read-only] text : QString
Cette propriété contient le texte descriptif affiché avec la barre de progression
Le texte renvoyé est identique à celui affiché au centre (ou, selon certains styles, à gauche) de la barre de progression.
La progression indiquée dans le texte peut être inférieure à la valeur minimale, ce qui signifie que la barre de progression est à l'état « réinitialisé » avant qu'une progression ne soit définie.
Dans l’implémentation par défaut, le texte contient soit une valeur en pourcentage indiquant la progression actuelle, soit il est vide car la barre de progression est à l’état « réinitialisé ».
Fonctions d’accès :
| virtual QString | text() const |
textDirection : Direction
Cette propriété définit le sens de lecture de l'text pour les barres de progression verticales
Cette propriété n'a aucun impact sur les barres de progression horizontales. Par défaut, la direction de lecture est « QProgressBar::TopToBottom ».
Fonctions d'accès :
| QProgressBar::Direction | textDirection() const |
| void | setTextDirection(QProgressBar::Direction textDirection) |
Voir également orientation et textVisible.
textVisible : bool
Cette propriété détermine si le pourcentage d'achèvement actuel doit être affiché
Cette propriété peut être ignorée par le style (par exemple, QMacStyle n'affiche jamais le texte).
Fonctions d’accès :
| bool | isTextVisible() const |
| void | setTextVisible(bool visible) |
Voir également textDirection.
value : int
Cette propriété contient la valeur actuelle de la barre de progression
Tenter de modifier la valeur actuelle pour lui attribuer une valeur hors de la plage minimum-maximum n'a aucun effet sur la valeur actuelle.
Fonctions d'accès :
| int | value() const |
| void | setValue(int value) |
Signal de notification :
| void | valueChanged(int value) |
Documentation des fonctions membres
[explicit] QProgressBar::QProgressBar(QWidget *parent = nullptr)
Crée une barre de progression à partir de l'parent.
Par défaut, la valeur minimale de l'incrément est fixée à 0 et la valeur maximale à 100.
Voir aussi setRange().
[virtual noexcept] QProgressBar::~QProgressBar()
Destructeur.
[override virtual protected] bool QProgressBar::event(QEvent *e)
Réimplémente : QWidget::event(QEvent *event).
[virtual protected] void QProgressBar::initStyleOption(QStyleOptionProgressBar *option) const
Initialisez ` option ` avec les valeurs fournies à l'adresse suivante : QProgressBar. Cette méthode est utile pour les sous-classes qui ont besoin d'un ` QStyleOptionProgressBar`, mais ne souhaitent pas renseigner elles-mêmes toutes les informations.
Voir également QStyleOption::initFrom().
[override virtual] QSize QProgressBar::minimumSizeHint() const
Réimplémente une fonction d'accès pour la propriété : QWidget::minimumSizeHint.
[override virtual protected] void QProgressBar::paintEvent(QPaintEvent *)
Réimplémente : QWidget::paintEvent(QPaintEvent *event).
[slot] void QProgressBar::reset()
Réinitialiser la barre de progression. La barre de progression « revient en arrière » et n'affiche plus aucune progression.
[slot] void QProgressBar::setRange(int minimum, int maximum)
Définit les valeurs minimale et maximale de la barre de progression respectivement sur minimum et maximum.
Si maximum est inférieur à minimum, minimum devient la seule valeur valide.
Si la valeur actuelle se situe en dehors de la nouvelle plage, la barre de progression est réinitialisée avec reset().
La valeur de QProgressBar peut être définie sur un état indéterminé à l’aide de setRange(0, 0).
Voir également minimum et maximum.
[override virtual] QSize QProgressBar::sizeHint() const
Réimplémente une fonction d'accès pour la propriété : QWidget::sizeHint.
[signal] void QProgressBar::valueChanged(int value)
Ce signal est émis lorsque la valeur affichée dans la barre de progression change. value correspond à la nouvelle valeur affichée par la barre de progression.
Remarque : signalde notification pour la propriété 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.
