QStyleOptionProgressBar Class
QStyleOptionProgressBar 类用于描述绘制进度条所需的参数。更多
| Header： | #include <QStyleOptionProgressBar> |
| CMake.QStyleOptionProgressBar 类 | 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) |
公共变量
| 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 样式选项的副本。
成员变量文档
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
该变量包含一个标志，表示文本是否可见。
如果该标志为 true，则文本可见。否则，文本不可见。默认值为 false。
另请参见 QProgressBar::textVisible 。
© 2025 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.
