Qt QProgressBar进度条控件

QProgressBar是进度条控件，进度条用来指示任务的完成情况

1 属性和方法

QProgressBar有很多属性，完整的可查看帮助文档。这里以QProgressBar为例，列出常用的属性和方法

1.1 值

进度条和值相关的属性包括：当前值、最大值、最小值

// 获取和设置当前值
int value() const;
void serValue(int);// 获取和设置最大值
int maximum() const;
void setMaximum(int);// 获取和设置最小值
int minimum() const;
void setMinimum(int);// 一次设置最大值和最小值
void serRange(int min, int max);// 复位当前值
void QProgressBar::reset();

注意：如果将最小值和最大值都设置为0，进度条会显示一个繁忙指示，而不会显示当前的值，如下：

1.2 方向

Qt中进度条有水平进度条和垂直进度条之分

只需修改QProgressBar的orientation属性，就可以将进度条的外观变为水平或者垂直的

// 获取和设置进度条
Qt::Orientation orientation() const;
void setOrientation(Qt::Orientation);

其中，Qt::Orientation 是一个枚举类型，有两种取值：

• Qt:Horizontal 水平
• Qt:Vertical 垂直

1.3 外观

可以设置进度条的文本是否显示

// 获取和设置进度条的文本是否显示
void isTextVisible() const;
void setTextVisible(bool visible);

设置文本的显示位置

Qt::Alignment alignment() const;
void setAlignment(Qt::Alignment alignemnt);

文本的显示格式，也就是进度条显示的进度值的方式

// 获取格式
QString format() const;// 设置格式
void setFormat(const QString &format);// 复位格式
void resetFormat();

格式有三种：

• %p - 百分比
• %v - 当前值
• %m - 最大值

还可以设置进度条的进度增长方向

// 获取和设置是外观反转
bool invertedAppearance() const;
void setInvertedApperarance(bool invert)

通常，进度条进度的增长方向从左到右

而外观反转，将进度条的进度增长方向修改为从右向左

1.4 信号和槽

// 当进度条的值改变时，发射该信号
void valueChanged(int value);

2 实例

本实例展示三个进度条的案例：文件下载、文件拷贝、网络请求

2.1 布局

在Ul设计师界面，拖拽对应的控件，修改显示的文字、控件的name，然后完成布局

2.2 代码实现

// 在widget.cpp中#include "widget.h"#include "ui_widget.h"Widget::Widget(QWidget *parent) : QWidget(parent), ui(new Ui::Widget) {ui->setupUi(this);// 初始化ui->pbDownload->setMaximum(100);ui->pbDownload->setMinimum(0);// ui->pbDownload->setRange(0, 100);ui->pbDownload->setAlignment(Qt::AlignLeft);ui->pbCopy->setMaximum(1000);ui->pbCopy->setMinimum(0);// 初始化定时器mTimerDownload = new QTimer(this);// 每个多长时间执行函数mTimerDownload->setInterval(50);mTimerCopy = new QTimer(this);mTimerCopy->setInterval(10);connect(ui->btnDownload, &QPushButton::clicked, this,&Widget::onBtnDownloadClicked);connect(ui->btnCopy, &QPushButton::clicked, this,&Widget::onBtnCopyClicked);// 时间到了触发信号connect(mTimerDownload, &QTimer::timeout, this, &Widget::onDownloadTimeout);connect(mTimerCopy, &QTimer::timeout, this, &Widget::onCopyTimeout);
}void Widget::onBtnDownloadClicked() {// 恢复到初始值ui->pbDownload->reset();// 当触发信号 启动定时器mTimerDownload->start();
}void Widget::onBtnCopyClicked() {// 恢复到初始值ui->pbCopy->reset();// 当触发信号 启动定时器mTimerCopy->start();
}// 时间到了调用这个函数
void Widget::onDownloadTimeout() {// 获取进度条当前值int currentValue = ui->pbDownload->value();if (currentValue >= ui->pbDownload->maximum()) {mTimerDownload->stop();QMessageBox::information(this, "提示", "文件下载完成");} else {ui->pbDownload->setValue(ui->pbDownload->value() + 1);qDebug() << ui->pbDownload->value();}
}void Widget::onCopyTimeout() {// 获取进度条当前值int currentValue = ui->pbCopy->value();if (currentValue >= ui->pbCopy->maximum()) {mTimerCopy->stop();QMessageBox::information(this, "提示", "文件拷贝完成");} else {ui->pbCopy->setValue(ui->pbCopy->value() + 1);qDebug() << ui->pbCopy->value();}
}Widget::~Widget() {delete ui;
}