QStyleOptionProgressBar Class
QStyleOptionProgressBar 类用于描述绘制进度条所需的参数。更多内容...
| 头文件： | #include <QStyleOptionProgressBar> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| 继承自： | QStyleOption |
公共类型
| enum | StyleOptionType { Type } |
| enum | StyleOptionVersion { Version } |
公共函数
| QStyleOptionProgressBar() | |
| QStyleOptionProgressBar(const QStyleOptionProgressBar &other) | |
| QStyleOptionProgressBar & | operator=(const QStyleOptionProgressBar &) |
公共变量
| bool | bottomToTop |
| bool | invertedAppearance |
| int | maximum |
| int | minimum |
| int | progress |
| QString | text |
| Qt::Alignment | textAlignment |
| bool | textVisible |
详细说明
QStyleOptionProgressBar 类的实例类型为 SO_ProgressBar，版本为 2。
该类型由QStyleOption 、其子类以及qstyleoption_cast()在内部使用，用于确定样式选项的类型。 通常情况下，除非您想创建自己的QStyleOption 子类和自己的样式，否则无需担心这一点。QStyleOption 子类使用该版本来实现扩展，同时保持兼容性。如果您使用qstyleoption_cast()，通常无需检查它。
出于性能考虑，成员函数较少，且对成员变量的访问是直接的（即使用. 或-> 运算符）。这使得这些结构体的使用非常直观，同时也强调了它们仅仅是样式函数所使用的参数。
另请参阅 QStyleOption 。
成员类型文档
enum QStyleOptionProgressBar::StyleOptionType
该枚举用于存储样式选项类型的相关信息，并针对每个QStyleOption 子类分别定义。
| 常量 | 常量值 | 描述 |
|---|---|---|
QStyleOptionProgressBar::Type | SO_ProgressBar | 提供的样式选项的类型（对于此类而言为SO_ProgressBar ）。 |
该类型由QStyleOption 、其子类以及qstyleoption_cast()在内部使用，以确定样式选项的类型。通常情况下，除非您想创建自己的QStyleOption 子类和自己的样式，否则无需担心这一点。
另请参阅 StyleOptionVersion 。
enum QStyleOptionProgressBar::StyleOptionVersion
该枚举用于存储样式选项的版本信息，并针对每个QStyleOption 子类进行定义。
| 常量 | 常量值 | 描述 |
|---|---|---|
QStyleOptionProgressBar::Version | 1 | 2 |
QStyleOption 子类使用该版本号来实现扩展，同时保持兼容性。如果您使用qstyleoption_cast()，通常无需检查该值。
另请参阅 StyleOptionType 。
成员函数文档
QStyleOptionProgressBar::QStyleOptionProgressBar()
创建一个 QStyleOptionProgressBar，并将成员变量初始化为默认值。
QStyleOptionProgressBar::QStyleOptionProgressBar(const QStyleOptionProgressBar &other)
创建other 样式选项的副本。
[noexcept default] QStyleOptionProgressBar &QStyleOptionProgressBar::operator=(const QStyleOptionProgressBar &)
将other 复制并赋值给此QStyleOptionProgressBar 实例。
成员变量文档
bool QStyleOptionProgressBar::bottomToTop
该变量用于控制当进度条为垂直方向时，文本是否从下往上显示
默认值为 false。
另请参阅 QProgressBar::textDirection 。
bool QStyleOptionProgressBar::invertedAppearance
该变量用于控制进度条的外观是否反转
默认值为 false。
另请参阅 QProgressBar::invertedAppearance 。
int QStyleOptionProgressBar::maximum
该变量存储进度条的最大值
这是进度条的最大值。默认值为 0。
另请参阅 QProgressBar::maximum 。
int QStyleOptionProgressBar::minimum
该变量存储进度条的最小值
这是进度条中的最小值。默认值为 0。
另请参阅 QProgressBar::minimum 。
int QStyleOptionProgressBar::progress
该变量存储进度条的当前进度
当前进度。值为QStyleOptionProgressBar::minimum - 1 表示进度尚未开始。默认值为 0。
另请参阅 QProgressBar::value 。
QString QStyleOptionProgressBar::text
该变量用于存储进度条的文本
进度条的文本通常只是以字符串形式表示的进度。空字符串表示进度条尚未开始。默认值为空字符串。
另请参阅 QProgressBar::text 。
Qt::Alignment QStyleOptionProgressBar::textAlignment
该变量存储了QProgressBar 中文本的对齐方式。
该变量可作为进度条中文字显示位置的参考。默认值为Qt::AlignLeft 。
bool QStyleOptionProgressBar::textVisible
该变量保存一个标志，用于指示文本是否可见
如果该标志为真，则文本可见；否则，文本不可见。默认值为假。
另请参阅 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.
