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

QProgressDialog 进度条不更新_嵌入式硬件

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,进度条会显示一个繁忙指示,而不会显示当前的值,如下:

QProgressDialog 进度条不更新_嵌入式硬件_02

1.2 方向

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

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

// 获取和设置滑动条的方向
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. 案例

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

QProgressDialog 进度条不更新_物联网_03

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