QProgressBar类
QProgressBar小部件提供了一个水平或垂直进度条。更多...
| 头文件 | #include <QProgressBar> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake | QT += widgets |
| 继承自 | QWidget |
公开类型
| 枚举 | Direction { 从上到下, 从下到上 } |
属性
|
|
公开函数
| QProgressBar(QWidget *parent = nullptr) | |
| virtual | ~QProgressBar() |
| Qt::Alignment | alignment() const |
| QString | format() const |
| bool | invertedAppearance() const |
| bool | isTextVisible() const |
| int | maximum() const |
| int | minimum() const |
| Qt::Orientation | orientation() const |
| void | resetFormat() |
| void | setAlignment(Qt::Alignment alignment) |
| void | setFormat(const QString &format) |
| void | setInvertedAppearance(bool invert) |
| void | setTextDirection(QProgressBar::Direction textDirection) |
| void | setTextVisible(bool visible) |
| virtual QString | text() const |
| QProgressBar::Direction | textDirection() const |
| int | value() const |
重定义的公开函数
| virtual QSize | minimumSizeHint() const override |
| virtual QSize | sizeHint() const override |
公共槽
| void | 重置() |
| void | setMaximum(int maximum) |
| void | setMinimum(int minimum) |
| void | setOrientation(Qt::Orientation) |
| void | setRange(int minimum, int maximum) |
| void | setValue(int value) |
信号
| void | valueChanged(int value) |
受保护函数
| virtual void | initStyleOption(QStyleOptionProgressBar *option) const |
重实现的受保护函数
| virtual bool | event(QEvent *e) override |
| virtual void | paintEvent(QPaintEvent *) override |
详细描述
进度条用于向用户提供操作的进度指示，并使他们确信应用程序仍在运行。
进度条使用步骤的概念。您通过指定最小和最大的可能步骤值来设置它，然后在您稍后给出当前步骤值时，它会显示完成的步骤百分比。计算方法是进度（value() - minimum()）除以maximum() - minimum()。
您可以使用setMinimum()和setMaximum指定最小和最大步骤数。当前步骤数用setValue设置。可以使用reset将进度条重置到开始位置。
如果最小值和最大值都设置为0，则栏将显示一个忙的指示器而不是步骤的百分比。这在例如使用QNetworkAccessManager下载项目而无法确定正在下载的项目大小时非常有用。
另请参阅QProgressDialog。
成员类型文档
枚举 QProgressBar::Direction
指定垂直进度条的文本读取方向。
| 常量 | 值 | 描述 |
|---|---|---|
QProgressBar::TopToBottom | 0 | 文本顺时针旋转90度。 |
QProgressBar::BottomToTop | 1 | 文本逆时针旋转90度。 |
注意，是否绘制文本取决于样式。目前CleanLooks和Plastique绘制文本。Mac、Windows和WindowsVista样式不绘制。
另请参阅textDirection。
属性文档
alignment : Qt::Alignment
此属性持有进度条的排列方式
访问函数
| Qt::Alignment | alignment() const |
| void | setAlignment(Qt::Alignment alignment) |
format : QString
此属性持有用于生成当前文本的字符串
%p - 由完成百分率替换。%v - 由当前值替换。%m - 由总步数替换。
默认值为 "%p%"。
访问函数
| QString | format() const |
| void | setFormat(const QString &format) |
| void | resetFormat() |
另请参阅text()。
invertedAppearance : bool
此属性表示进度条是否显示反向的进度
如果此属性为 true，则进度条将在相反方向增长（例如从右到左）。默认情况下，进度条不反向。
访问函数
| bool | invertedAppearance() const |
| void | setInvertedAppearance(bool invert) |
另请参阅orientation 和 layoutDirection。
maximum : int
此属性包含进度条的最大值
设置此属性时，根据需要调整 minimum 以确保范围有效。如果当前值超出了新的范围，则使用 reset() 重置进度条。
访问函数
| int | maximum() const |
| void | setMaximum(int maximum) |
minimum : int
此属性包含进度条的最小值
设置此属性时，根据需要调整 maximum 以确保范围有效。如果当前值超出了新的范围，则使用 reset() 重置进度条。
访问函数
| int | minimum() const |
| void | setMinimum(int minimum) |
orientation : Qt::Orientation
此属性包含进度条的方向
方向必须是 Qt::Horizontal（默认）或 Qt::Vertical。
访问函数
| Qt::Orientation | orientation() const |
| void | setOrientation(Qt::Orientation) |
另请参阅invertedAppearance 和 textDirection。
[只读] text : const QString
此属性包含与进度条一起显示的描述性文本
返回的文本与进度条中间（或某些样式中的左侧）显示的文本相同。
文本中显示的进度可能小于最小值，表示在设置任何进度之前，进度条处于“重置”状态。
在默认实现中，文本包含表示迄今为止进度的百分比值，或者因为进度条处于重置状态而为空。
访问函数
| virtual QString | text() const |
textDirection : Direction
此属性包含垂直进度条中 text 的阅读方向
此属性对水平进度条没有影响。默认情况下，阅读方向是 QProgressBar::TopToBottom。
访问函数
| QProgressBar::Direction | textDirection() const |
| void | setTextDirection(QProgressBar::Direction textDirection) |
也见orientation 和 textVisible.
textVisible : bool
此属性表示是否应显示当前的完成百分比
样式可能会忽略此属性（例如，QMacStyle从不绘制文本）。
访问函数
| bool | isTextVisible() const |
| void | setTextVisible(bool visible) |
另请参阅textDirection。
value : int
此属性表示进度条当前的值
尝试将当前值更改为最小值和最大值范围之外的值将不会对当前值产生影响。
访问函数
| int | value() const |
| void | setValue(int value) |
通知信号
| void | valueChanged(int value) |
成员函数文档
[显式] QProgressBar::QProgressBar(QWidget *parent = nullptr)
使用指定的 parent 创建一个进度条。
默认情况下，最小步骤值设置为0，最大值设置为100。
也见setRange（）。
[虚拟 noexcept] QProgressBar::~QProgressBar()
析构函数。
[重写虚拟受保护] bool QProgressBar::event(QEvent *e)
重实现了： QWidget::event(QEvent *event)。
[虚拟受保护] void QProgressBar::initStyleOption(QStyleOptionProgressBar *option) const
使用来自此 QProgressBar 的值初始化 option。此方法对于子类很有用，当它们需要 QStyleOptionProgressBar 但不想自己填写所有信息时。
[重写虚拟] QSize QProgressBar::minimumSizeHint() const
重实现了属性访问函数： QWidget::minimumSizeHint。
[重写虚拟受保护] void QProgressBar::paintEvent(QPaintEvent *)
重实现了： QWidget::paintEvent(QPaintEvent *event)。
[槽] void QProgressBar::reset()
重置进度条。进度条“倒放”并显示出无进度。
[槽] void QProgressBar::setRange(int minimum, int maximum)
将进度条的最小值和最大值分别设置为minimum 和maximum。
如果最大值小于最小值，则最小值成为唯一的合法值。
如果当前值超出新范围，进度条将使用reset()重置。
可以通过使用setRange(0, 0)将QProgressBar设置为不确定状态。
[重写虚函数] QSize QProgressBar::sizeHint() const
重新实现了属性访问函数：QWidget::sizeHint。
[信号] void QProgressBar::valueChanged(int value)
当进度条显示的值发生变化时，此信号被发出。参数value是进度条显示的新值。
注意：属性value的通告信号。
© 2024 Qt公司 Ltd. 本文档贡献的部分是各自所有者的版权。本文档按自由软件基金会发布的GNU自由文档许可版本1.3的条款进行许可。Qt及其相关标志是芬兰以及全球其他地区的Qt公司 Ltd.的商标。所有其他商标均为各自所有者的财产。
