【QT开发笔记-基础篇】| 第二章 常用控件 | 2.10 进度条 QProgressBar

本节对应的视频讲解：B_站_链_接

https://www.bilibili.com/video/BV1tt4y147yv

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();
    }
}

本节对应的视频讲解：B_站_链_接
https://www.bilibili.com/video/BV1tt4y147yv