Sur cette page

QStyleOptionProgressBar Class

La classe `QStyleOptionProgressBar` sert à définir les paramètres nécessaires au tracé d'une barre de progression. En savoir plus...

En-tête : #include <QStyleOptionProgressBar>
CMake : find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake : QT += widgets
Hérite de : QStyleOption

Types publics

enum StyleOptionType { Type }
enum StyleOptionVersion { Version }

Fonctions publiques

QStyleOptionProgressBar()
QStyleOptionProgressBar(const QStyleOptionProgressBar &other)
QStyleOptionProgressBar &operator=(const QStyleOptionProgressBar &)

Variables publiques

bool bottomToTop
bool invertedAppearance
int maximum
int minimum
int progress
QString text
Qt::Alignment textAlignment
bool textVisible

Description détaillée

Une instance de la classe QStyleOptionProgressBar est de type SO_ProgressBar et de version 2.

Ce type est utilisé en interne par QStyleOption, ses sous-classes et qstyleoption_cast() pour déterminer le type d’option de style. En général, vous n’avez pas à vous en soucier, sauf si vous souhaitez créer votre propre sous-classe de QStyleOption et vos propres styles. La version est utilisée par les sous-classes de QStyleOption pour implémenter des extensions sans rompre la compatibilité. Si vous utilisez qstyleoption_cast(), vous n’avez normalement pas besoin de la vérifier.

Pour des raisons de performances, il y a peu de fonctions membres et l’accès aux variables membres est direct (c’est-à-dire à l’aide des opérateurs . ou -> ). Cela rend les structures simples à utiliser et souligne le fait qu’il s’agit simplement de paramètres utilisés par les fonctions de style.

Voir également QStyleOption.

Documentation sur les types membres

enum QStyleOptionProgressBar::StyleOptionType

Cette énumération sert à stocker des informations sur le type de l'option de style et est définie pour chaque sous-classe de ` QStyleOption `.

ConstanteValeurDescription
QStyleOptionProgressBar::TypeSO_ProgressBarLe type de l'option de style fournie (SO_ProgressBar pour cette classe).

Ce type est utilisé en interne par QStyleOption, ses sous-classes et la méthode qstyleoption_cast() pour déterminer le type de l'option de style. En général, vous n'avez pas à vous en soucier, sauf si vous souhaitez créer votre propre sous-classe de QStyleOption et vos propres styles.

Voir également StyleOptionVersion.

enum QStyleOptionProgressBar::StyleOptionVersion

Cette énumération sert à contenir des informations sur la version de l'option de style et est définie pour chaque sous-classe de ` QStyleOption `.

ConstanteValeurDescription
QStyleOptionProgressBar::Version12

La version est utilisée par les sous-classes de ` QStyleOption ` pour implémenter des extensions sans rompre la compatibilité. Si vous utilisez ` qstyleoption_cast()`, vous n’avez normalement pas besoin de la vérifier.

Voir aussi StyleOptionType.

Documentation des fonctions membres

QStyleOptionProgressBar::QStyleOptionProgressBar()

Crée un objet `QStyleOptionProgressBar` en initialisant ses variables membres à leurs valeurs par défaut.

QStyleOptionProgressBar::QStyleOptionProgressBar(const QStyleOptionProgressBar &other)

Crée une copie de l'option de style « other ».

[noexcept default] QStyleOptionProgressBar &QStyleOptionProgressBar::operator=(const QStyleOptionProgressBar &)

Attribue par copie la variable ` other ` à cette instance de ` QStyleOptionProgressBar `.

Documentation sur les variables membres

bool QStyleOptionProgressBar::bottomToTop

Cette variable indique si le texte s'affiche de bas en haut lorsque la barre de progression est verticale

La valeur par défaut est « false ».

Voir également QProgressBar::textDirection.

bool QStyleOptionProgressBar::invertedAppearance

Cette variable indique si l'apparence de la barre de progression est inversée

La valeur par défaut est « false ».

Voir aussi QProgressBar::invertedAppearance.

int QStyleOptionProgressBar::maximum

Cette variable contient la valeur maximale de la barre de progression

Il s'agit de la valeur maximale de la barre de progression. La valeur par défaut est 0.

Voir également QProgressBar::maximum.

int QStyleOptionProgressBar::minimum

Cette variable contient la valeur minimale de la barre de progression

Il s'agit de la valeur minimale de la barre de progression. La valeur par défaut est 0.

Voir également QProgressBar::minimum.

int QStyleOptionProgressBar::progress

Cette variable contient la progression actuelle de la barre de progression

La progression actuelle. Une valeur comprise entre QStyleOptionProgressBar::minimum et 1 indique que la progression n'a pas encore commencé. La valeur par défaut est 0.

Voir également QProgressBar::value.

QString QStyleOptionProgressBar::text

Cette variable contient le texte de la barre de progression

Le texte de la barre de progression correspond généralement à la progression exprimée sous forme de chaîne de caractères. Une chaîne vide indique que la barre de progression n'a pas encore démarré. La valeur par défaut est une chaîne vide.

Voir également QProgressBar::text.

Qt::Alignment QStyleOptionProgressBar::textAlignment

Cette variable contient l'alignement du texte dans la barre de progression QProgressBar.

Elle peut servir de repère pour déterminer l'emplacement du texte dans la barre de progression. La valeur par défaut est « Qt::AlignLeft ».

bool QStyleOptionProgressBar::textVisible

Cette variable contient un indicateur précisant si le texte est visible ou non

Si cet indicateur est à « true », le texte est visible. Dans le cas contraire, le texte n'est pas visible. La valeur par défaut est « false ».

Voir également QProgressBar::textVisible.

© 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.