QProgressBar
是进度条控件,进度条用来指示任务的完成情况
1. 属性和方法
QProgressBar
有很多属性,完整的可查看帮助文档。这里列出常用的属性和方法:
1.1 值
进度条和值相关的属性包括:当前值、最大值、最小值
// 获取和设置当前值
int value() const;
void setValue(int);
// 获取和设置最大值
int maximum() const;
void setMaximum(int);
// 获取和设置最小值
int minimum() const;
void setMinimum(int);
// 一次设置最大值和最小值
void setRange(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 外观
可以设置进度条的文本是否显示
// 获取和设置进度条的文本是否显示
bool isTextVisible() const
void setTextVisible(bool visible)
设置文本的显示位置
Qt::Alignment alignment() const
void setAlignment(Qt::Alignment alignment)
文本的显示格式,也就是进度条显示的进度值的方式
// 获取格式
QString format() const;
// 设置格式
void setFormat(const QString &format);
// 复位格式
void resetFormat()
格式有三种:
-
%p
- 百分比 -
%v
- 当前值 -
%m
- 最大值
还可以设置进度条的进度增长方向
// 获取和设置是否外观反转
bool invertedAppearance() const
void setInvertedAppearance(bool invert)
通常,进度条进度的增长方向从左到右
而外观反转,将进度条的进度增长方向修改为从右向左
1.4 信号槽
// 当进度条的值改变时,发射该信号
void valueChanged(int value)
2. 案例
本案例展示三个进度条的案例:文件下载、文件拷贝、网络请求
2.1 布局
在 UI
设计师界面,拖拽对应的控件,修改显示的文字、控件的 name
,然后完成布局
2.2 代码实现
完整的项目,在本节视频的置顶评论下载即可
Widget::Widget(QWidget *parent)
: QWidget(parent)
, ui(new Ui::Widget)
{
ui->setupUi(this);
// 1.下载
ui->pbDownload->setMinimum(0);
ui->pbDownload->setMaximum(100);
// ui->pbDownload->setRange(0, 100);
// 设置文本的显示位置
ui->pbDownload->setAlignment(Qt::AlignRight);
// 设置是否显示文本
// ui->pbDownload->setTextVisible(false);
mTimerDownload = new QTimer();
mTimerDownload->setInterval(100);
connect(ui->btnDownload, &QPushButton::clicked, this, &Widget::onBtnDownloadClicked);
connect(mTimerDownload, &QTimer::timeout, this, &Widget::onDownloadTimeout);
// 2.拷贝
ui->pbCopy->setMinimum(0);
ui->pbCopy->setMaximum(1000);
// ui->pbCopy->setRange(0, 1000);
mTimerCopy = new QTimer();
mTimerCopy->setInterval(12);
connect(ui->btnCopy, &QPushButton::clicked, this, &Widget::onBtnCopyClicked);
connect(mTimerCopy, &QTimer::timeout, this, &Widget::onCopyTimeout);
}
Widget::~Widget()
{
delete ui;
}
void Widget::onBtnDownloadClicked()
{
ui->pbDownload->reset();
mTimerDownload->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::onBtnCopyClicked()
{
ui->pbCopy->reset();
mTimerCopy->start();
}
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();
}
}