En esta página

QStyleOptionProgressBar Class

La clase QStyleOptionProgressBar se utiliza para definir los parámetros necesarios para dibujar una barra de progreso. Más información...

Encabezado: #include <QStyleOptionProgressBar>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
Heredado de: QStyleOption

Tipos públicos

enum StyleOptionType { Type }
enum StyleOptionVersion { Version }

Funciones públicas

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

Variables públicas

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

Descripción detallada

Una instancia de la clase QStyleOptionProgressBar tiene el tipo SO_ProgressBar y la versión 2.

QStyleOption, sus subclases y qstyleoption_cast() utilizan este tipo internamente para determinar el tipo de opción de estilo. En general, no es necesario que te preocupes por esto a menos que quieras crear tu propia subclase de ` QStyleOption ` y tus propios estilos. La versión es utilizada por las subclases de ` QStyleOption ` para implementar extensiones sin romper la compatibilidad. Si utilizas ` qstyleoption_cast()`, normalmente no es necesario que la compruebes.

Por motivos de rendimiento, hay pocas funciones miembro y el acceso a las variables miembro es directo (es decir, mediante el operador . o -> ). Esto hace que las estructuras sean fáciles de usar y pone de relieve que se trata simplemente de parámetros utilizados por las funciones de estilo.

Véase también QStyleOption.

Documentación sobre los tipos de miembros

enum QStyleOptionProgressBar::StyleOptionType

Esta enumeración se utiliza para almacenar información sobre el tipo de la opción de estilo y se define para cada subclase de ` QStyleOption `.

ConstanteValorDescripción
QStyleOptionProgressBar::TypeSO_ProgressBarEl tipo de opción de estilo proporcionada (SO_ProgressBar para esta clase).

El tipo lo utilizan internamente QStyleOption, sus subclases y qstyleoption_cast() para determinar el tipo de opción de estilo. En general, no es necesario que te preocupes por esto a menos que quieras crear tu propia subclase de QStyleOption y tus propios estilos.

Véase también StyleOptionVersion.

enum QStyleOptionProgressBar::StyleOptionVersion

Esta enumeración se utiliza para almacenar información sobre la versión de la opción de estilo y se define para cada subclase de ` QStyleOption `.

ConstanteValorDescripción
QStyleOptionProgressBar::Version12

Las subclases de ` QStyleOption ` utilizan esta versión para implementar extensiones sin romper la compatibilidad. Si utilizas ` qstyleoption_cast()`, normalmente no es necesario que la compruebes.

Véase también StyleOptionType.

Documentación de funciones miembro

QStyleOptionProgressBar::QStyleOptionProgressBar()

Crea un objeto `QStyleOptionProgressBar` e inicializa las variables de miembros con sus valores por defecto.

QStyleOptionProgressBar::QStyleOptionProgressBar(const QStyleOptionProgressBar &other)

Crea una copia de la opción de estilo « other ».

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

Asigna por copia other a esta instancia de QStyleOptionProgressBar.

Documentación de variables de miembro

bool QStyleOptionProgressBar::bottomToTop

Esta variable indica si el texto se lee de abajo hacia arriba cuando la barra de progreso es vertical

El valor por defecto es «false».

Véase también QProgressBar::textDirection.

bool QStyleOptionProgressBar::invertedAppearance

Esta variable indica si la apariencia de la barra de progreso está invertida

El valor por defecto es «false».

Véase también QProgressBar::invertedAppearance.

int QStyleOptionProgressBar::maximum

Esta variable contiene el valor máximo de la barra de progreso

Este es el valor máximo de la barra de progreso. El valor por defecto es 0.

Véase también QProgressBar::maximum.

int QStyleOptionProgressBar::minimum

Esta variable contiene el valor mínimo de la barra de progreso

Este es el valor mínimo de la barra de progreso. El valor por defecto es 0.

Véase también QProgressBar::minimum.

int QStyleOptionProgressBar::progress

Esta variable contiene el progreso actual de la barra de progreso

El progreso actual. Un valor de QStyleOptionProgressBar::minimum - 1 indica que el progreso aún no ha comenzado. El valor por defecto es 0.

Véase también QProgressBar::value.

QString QStyleOptionProgressBar::text

Esta variable contiene el texto de la barra de progreso

El texto de la barra de progreso suele ser simplemente el progreso expresado como una cadena de caracteres. Una cadena vacía indica que la barra de progreso aún no se ha iniciado. El valor por defecto es una cadena vacía.

Véase también QProgressBar::text.

Qt::Alignment QStyleOptionProgressBar::textAlignment

Esta variable contiene la alineación del texto de la barra de progreso QProgressBar.

Se puede utilizar como guía para saber dónde debe aparecer el texto en la barra de progreso. El valor por defecto es Qt::AlignLeft.

bool QStyleOptionProgressBar::textVisible

Esta variable contiene un indicador que señala si el texto es visible o no

Si este indicador es «true», el texto está visible. En caso contrario, el texto no está visible. El valor por defecto es «false».

Véase también 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.