QProgressBar Class
Le widget QProgressBar fournit une barre de progression horizontale ou verticale. Plus d'informations...
| En-tête : | #include <QProgressBar> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake : | QT += widgets |
| Héritages : | 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 |
Emplacements 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 est utilisée pour donner à l'utilisateur une indication de la progression d'une opération et pour le rassurer sur le fait que l'application est toujours en cours d'exécution.
La barre de progression utilise le concept d'étapes. Vous la configurez en spécifiant les valeurs minimale et maximale possibles des étapes, et elle affichera le pourcentage d'étapes accomplies lorsque vous lui donnerez ultérieurement la valeur de l'étape en cours. Le pourcentage est calculé en divisant la progression (value() - minimum()) par maximum() - minimum().
Vous pouvez spécifier le nombre minimum et maximum d'étapes avec setMinimum() et setMaximum. Le nombre actuel de pas est défini avec setValue(). La barre de progression peut être ramenée au début avec reset().
Si le minimum et le maximum sont tous deux fixés à 0, la barre affiche un indicateur d'activité au lieu d'un pourcentage d'étapes. Ceci est utile, par exemple, lorsque vous utilisez QNetworkAccessManager pour télécharger des éléments qui ne peuvent pas déterminer la taille de l'élément téléchargé.
Voir également QProgressDialog.
Documentation sur les types de membres
enum QProgressBar::Direction
Spécifie le sens de lecture de text pour les barres de progression verticales.
| Constante | Valeur | Description |
|---|---|---|
QProgressBar::TopToBottom | 0 | Le texte est tourné de 90 degrés dans le sens des aiguilles d'une montre. |
QProgressBar::BottomToTop | 1 | Le texte est tourné de 90 degrés dans le sens inverse des aiguilles d'une montre. |
Le fait que le texte soit dessiné ou non dépend du style. Actuellement, les styles CleanLooks et Plastique affichent le texte. Les styles Mac, Windows et WindowsVista ne le font pas.
Voir également 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 utilisée pour générer le texte actuel
%p - est remplacé par le pourcentage de réalisation. %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é indique si une barre de progression affiche ou non sa progression de manière inversée
Si cette propriété vaut true, la barre de progression croît 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é contient la valeur maximale de la barre de progression
Lors de la définition de cette propriété, le site minimum est ajusté si nécessaire pour s'assurer 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 reset().
Fonctions d'accès :
| int | maximum() const |
| void | setMaximum(int maximum) |
minimum : int
Cette propriété contient la valeur minimale de la barre de progression
Lors de la définition de cette propriété, le site maximum est ajusté si nécessaire pour s'assurer 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 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 (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 le même que celui affiché au centre (ou dans certains styles, à gauche) de la barre de progression.
La progression affichée dans le texte peut être inférieure à la valeur minimale, ce qui indique que la barre de progression est dans l'état "réinitialisé" avant que toute progression ne soit définie.
Dans l'implémentation par défaut, le texte contient soit une valeur en pourcentage qui indique la progression jusqu'à présent, soit il est vide parce que la barre de progression est dans l'état de réinitialisation.
Fonctions d'accès :
| virtual QString | text() const |
textDirection : Direction
Cette propriété définit le sens de lecture de text pour les barres de progression verticales
Cette propriété n'a aucun impact sur les barres de progression horizontales. Par défaut, le sens de lecture est QProgressBar::TopToBottom.
Fonctions d'accès :
| QProgressBar::Direction | textDirection() const |
| void | setTextDirection(QProgressBar::Direction textDirection) |
Voir aussi orientation et textVisible.
textVisible : bool
Cette propriété indique si le pourcentage d'achèvement en cours doit être affiché
Cette propriété peut être ignorée par le style (par exemple, QMacStyle ne dessine 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
Toute tentative de modification de la valeur actuelle en dehors 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 Notificateur :
| void | valueChanged(int value) |
Member Function Documentation
[explicit] QProgressBar::QProgressBar(QWidget *parent = nullptr)
Construit une barre de progression avec la valeur donnée parent.
Par défaut, la valeur minimale du pas 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
Initialiser option avec les valeurs de QProgressBar. Cette méthode est utile pour les sous-classes qui ont besoin d'un QStyleOptionProgressBar, mais qui ne veulent pas remplir toutes les informations elles-mêmes.
Voir aussi QStyleOption::initFrom().
[override virtual] QSize QProgressBar::minimumSizeHint() const
Réimplémente une fonction d'accès à 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 "rembobine" et n'indique aucune progression.
[slot] void QProgressBar::setRange(int minimum, int maximum)
Fixe les valeurs minimale et maximale de la barre de progression à minimum et maximum respectivement.
Si maximum est plus petit que minimum, minimum devient la seule valeur légale.
Si la valeur actuelle se situe en dehors de la nouvelle plage, la barre de progression est réinitialisée à l'aide de reset().
Le site QProgressBar peut être mis dans un état indéterminé en utilisant setRange(0, 0).
Voir également minimum et maximum.
[override virtual] QSize QProgressBar::sizeHint() const
Réimplémente une fonction d'accès à 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 est la nouvelle valeur affichée par la barre de progression.
Note : Signal de 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.
