En esta página

QStyleOptionProgressBar Class

La clase QStyleOptionProgressBar se utiliza para describir los parámetros necesarios para dibujar una barra de progreso. Más...

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

Tipos Públicos

enum StyleOptionType { Type }
enum StyleOptionVersion { Version }

Funciones Públicas

QStyleOptionProgressBar()
QStyleOptionProgressBar(const QStyleOptionProgressBar &other)

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.

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

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

Véase también QStyleOption.

Documentación de los tipos miembros

enum QStyleOptionProgressBar::StyleOptionType

Este enum se utiliza para guardar 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 es utilizado internamente por QStyleOption, sus subclases y qstyleoption_cast() para determinar el tipo de opción de estilo. En general no necesitas preocuparte por esto a menos que quieras crear tu propia subclase QStyleOption y tus propios estilos.

Véase también StyleOptionVersion.

enum QStyleOptionProgressBar::StyleOptionVersion

Este enum se utiliza para guardar información sobre la versión de la opción de estilo, y se define para cada subclase de QStyleOption.

ConstanteValorDescripción
QStyleOptionProgressBar::Version12

La versión es utilizada por las subclases de QStyleOption para implementar extensiones sin romper la compatibilidad. Si utiliza qstyleoption_cast(), normalmente no necesita comprobarla.

Véase también StyleOptionType.

Documentación de funciones miembro

QStyleOptionProgressBar::QStyleOptionProgressBar()

Construye una QStyleOptionProgressBar, inicializando las variables miembros a sus valores por defecto.

QStyleOptionProgressBar::QStyleOptionProgressBar(const QStyleOptionProgressBar &other)

Construye una copia de la opción de estilo other.

Documentación de la variable miembro

bool QStyleOptionProgressBar::bottomToTop

Esta variable indica si el texto se lee de abajo a 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 mantiene 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 es normalmente el progreso expresado como una cadena. 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 en QProgressBar.

Puede usarse como guía para saber dónde debe estar el texto en la barra de progreso. El valor por defecto es Qt::AlignLeft.

bool QStyleOptionProgressBar::textVisible

Esta variable contiene una bandera que indica si el texto es visible o no

Si este indicador es verdadero, el texto es visible. En caso contrario, el texto no es 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.