本文详细介绍了QProgressDialog在Qt中的应用，包括其构造函数、成员函数以及在处理耗时操作时与线程的配合，展示了如何在不同场景下使用QThread、QObject、QRunnable和QtConcurrent模块来优化进度显示和用户体验。
1 QProgressDialog概述
QProgressDialog类提供耗时操作的进度条。
进度对话框用于向用户指示操作将花费多长时间，并演示应用程序没有冻结。此外，QPorgressDialog还可以给用户一个中止操作的机会。
进度对话框的一个常见问题是很难知道何时使用它们;操作在不同的硬件上花费不同的时间。QProgressDialog为这个问题提供了一个解决方案:它估计操作将花费的时间(基于步骤的时间)，并且仅在估计超过minimumDuration()(默认为4秒)时才显示它自己。
使用setMinimum()和setMaximum()或构造函数设置操作中的“steps”数，并在操作进行时调用setValue()。steps数可以任意选择。它可以是复制的文件数、接收的字节数、通过算法主循环的迭代次数，或者其他合适的单位。进度从setMinimum()设置的值开始，当使用setMaximum()设置的值作为参数调用setValue()时，进度对话框显示操作已经完成。
在操作结束时，对话框会自动重置并隐藏自己。使用setAutoReset()和setAutoClose()来改变这种行为。
注意，如果设置了一个新的最大值(使用setMaximum()或setRange())，它等于你的当前值()，无论如何对话框都不会关闭。
QProgressDialog progress;
progress.setMaximun(100);
Progress.setValue(100);
以上代码，对话框不会自动隐藏。
QProgressDialog有两种使用方式:模态和非模态。
与非模态QProgressDialog相比，模态QProgressDialog对于程序员来说更容易使用。在循环中执行操作，每隔一段时间调用setValue()，并使用wasCanceled()检查是否取消。
例如:
QProgressDialog progress("复制文件...", "中止", 0, numFiles, this);
progress.setWindowModality(Qt::WindowModal);
for (int i = 0; i < numFiles; i++) {
progress.setValue(i);
if (progress.wasCanceled())
break;
// 开始复制
// ......
}
// 复制完成，将最大值设置给当前值，对话框自动隐藏，关闭
progress.setValue(numFiles);
2 QProgressDialog常用函数
2.1 构造函数：
- QProgressDialog(QWidget *parent = Q_NULLPTR, Qt::WindowFlags f = Qt::WindowFlags())：创建一个默认的进度对话框，parent是对话框的父部件，f是对话框的窗口标志。
- QProgressDialog(const QString &labelText, const QString &cancelButtonText, int minimum, int maximum, QWidget *parent = Q_NULLPTR, Qt::WindowFlags f = Qt::WindowFlags())：创建一个带有文本标签、取消按钮和进度范围的进度对话框。labelText是标签的文本，cancelButtonText是取消按钮的文本，minimum和maximum指定了进度的范围。
2.2 成员函数：
- void cancel()：重置进度对话框，将wasCanceled()标记为true，直到进度对话框被重置。进度对话框将隐藏起来。
- void canceled()：在点击取消按钮时发射的信号，默认与cancel()槽连接。
- void open(QObject *receiver, const char *member)：打开对话框，并将其canceled()信号连接到receiver对象的member槽上。
- void reset()：重置进度对话框，如果autoClose()为true，则对话框将隐藏。
- void setBar(QProgressBar *bar)：设置进度条部件。
- void setCancelButton(QPushButton *cancelButton)：设置取消按钮部件。
- void setCancelButtonText(const QString &cancelButtonText)：设置取消按钮的文本。
- void setLabel(QLabel *label)：设置标签部件。
- void setRange(int minimum, int maximum)：设置进度范围。
- QSize sizeHint() const：返回适合对话框内容的大小。
2.3 常用方法示例代码
CustomProgress::CustomProgress(QWidget *parent) : QProgressDialog(parent)
{
// 设置窗体Flags, 对话框 | 只有关闭按钮，无问号
this->setWindowFlags(Qt::Dialog | Qt::WindowCloseButtonHint);
// 设置取消按钮文本
this->setCancelButtonText("取消");
// 设置进度条区间,等同分别设置最小值 和 最大值
setRange(0, 100);
// 设置最小值
setMinimum(0);
// 设置最大值
setMaximum(100);
// 设置当前值
setValue(0);
// 设置文本,一般在进度条上方显示
setLabelText("helloworld");
// 设置自动关闭，当reset()时，对话框自动关闭，默认为true
setAutoClose(true);
// 设置自动重置，当reset()或当前值 == 最大值时，重置
setAutoReset(true);
connect(this, &CustomProgress::canceled, this, &CustomProgress::cancel);
// 设置对话框窗体标题
this->setWindowTitle("等待...");
}
3 线程Qthread
当在主线程里，进行耗时操作，然后加载进度对话框时，会发现，对话框进度条会卡死不动，然后耗时操作结束，对话框进度条直接关闭，界面感官不友好。
因此需要将耗时操作放到线程内操作，主线程就进行进度显示。界面也不会卡死。
QThread类提供了一种独立于平台的方式来管理线程。
QThread对象管理程序中的一个控制线程。QThreads在run()中开始执行。默认情况下，run()通过调用exec()启动事件循环，并在线程内运行Qt事件循环。
此外，还可以通过使用QObject::moveToThread()将工作对象移动到线程中来使用它们。
下面是四种线程使用方式与进度框相结合，模拟处理耗时操作，主界面显示进度。
3.1 继承QThread，重写run()方法
.h
class C_Thread : public QThread
{
Q_OBJECT
public:
explicit C_Thread(int nMax, QObject *parent = nullptr);
virtual void run() override;
signals:
void emit_sendValue(int nValue);
private:
int m_nMax;
};
.cpp
#include "Thread.h"
C_Thread::C_Thread(int nMax, QObject *parent) : QThread(parent), m_nMax(nMax)
{
}
void C_Thread::run()
{
int i = 0;
while (i < m_nMax) {
msleep(100);
++i;
emit emit_sendValue(i);
}
}
当进行start()时，自动调用run()，每过100ms，发送一个数据，主界面进行显示
3.2 继承QObject，之后添加到线程moveToThread()，使用信号和槽方式
需要将进行耗时操作的类，移动到线程中，之后以信号和槽的方式和进度框进行交互
.h
class C_ThreadObject : public QObject
{
Q_OBJECT
public:
explicit C_ThreadObject(int nMax, QObject *parent = nullptr);
signals:
void emit_sendValue(int nValue);
public slots:
void slot_dealValue();
private:
int m_nMax;
};
.cpp
C_ThreadObject::C_ThreadObject(int nMax, QObject *parent) : QObject(parent), m_nMax(nMax)
{
}
void C_ThreadObject::slot_dealValue()
{
int i = 0;
while (i < m_nMax) {
QThread::msleep(100);
++i;
emit emit_sendValue(i);
}
}
3.3 继承QRunnable
重写run()，然后通过线程池调用
.h
class C_ThreadRunnable :public QObject, public QRunnable
{
Q_OBJECT
public:
explicit C_ThreadRunnable(int nMax);
signals:
void emit_sendValue(int nValue);
public slots:
protected:
virtual void run() override;
private:
int m_nMax;
};
.cpp
C_ThreadRunnable::C_ThreadRunnable(int nMax) : m_nMax(nMax)
{
}
void C_ThreadRunnable::run()
{
int i = 0;
while (i < m_nMax) {
QThread::msleep(100);
++i;
emit emit_sendValue(i);
}
}
3.4 使用QtConcurrent模块
Qt Concurrent模块扩展了Qt Core模块中的基本线程支持，简化了可以在所有可用CPU内核上并行执行的代码开发。
.h
void MainWindow::dealValue()
{
int i = 0;
while (i < m_nMax) {
QThread::msleep(100);
++i;
emit emit_sendValue(i);
}
}
.cpp
QtConcurrent::run(this, &MainWindow::dealValue);
3.5 主线程调用
创建各个线程对象，然后进行模拟耗时操作，进度框显示进度
如果在构造中new过QProgressDialog对象，默认4秒后，会自动显示，可以调用其close()方法，不用显示。
.h
class MainWindow : public QMainWindow
{
Q_OBJECT
public:
explicit MainWindow(QWidget *parent = nullptr);
~MainWindow();
void dealValue();
signals:
void emit_start();
void emit_sendValue(int nValue);
private slots:
void on_btn_TimeConsumingOperation_clicked();
private:
Ui::MainWindow *ui;
int m_nMax;
C_DlgProgress* m_pDlgProgress;
C_Thread* m_pTread;
C_ThreadRunnable* m_pThreadRunnable;
C_ThreadObject* m_pThreadObject;
QThread* m_pThreadUsedObject;
};
.cpp
#include "mainwindow.h"
#include "ui_mainwindow.h"
#include <QThreadPool>
#include <QtConcurrent>
#include <QDebug>
MainWindow::MainWindow(QWidget *parent) :
QMainWindow(parent),
ui(new Ui::MainWindow)
{
ui->setupUi(this);
m_nMax = 20;
m_pDlgProgress = new C_DlgProgress(this);
m_pDlgProgress->setRange(0, m_nMax);
// 1. 继承QThread
m_pTread = new C_Thread(m_nMax, this);
connect(m_pTread, &C_Thread::emit_sendValue, this, [=](int nValue){
m_pDlgProgress->setValue(nValue);
});
// 2. 继承QRunnable
m_pThreadRunnable = new C_ThreadRunnable(m_nMax);
connect(m_pThreadRunnable, &C_ThreadRunnable::emit_sendValue, this, [=](int nValue){
m_pDlgProgress->setValue(nValue);
});
// 3. 继承QObject
m_pThreadObject = new C_ThreadObject(m_nMax);
connect(this, &MainWindow::emit_start, m_pThreadObject, &C_ThreadObject::slot_dealValue);
connect(m_pThreadObject, &C_ThreadObject::emit_sendValue, this, [=](int nValue){
m_pDlgProgress->setValue(nValue);
});
m_pThreadUsedObject = new QThread(this);
m_pThreadObject->moveToThread(m_pThreadUsedObject);
m_pThreadUsedObject->start();
// 0. 在主线程处理耗时操作
connect(this, &MainWindow::emit_sendValue, this, [=](int nValue){
m_pDlgProgress->setValue(nValue);
});
}
MainWindow::~MainWindow()
{
if(m_pThreadUsedObject)
{
m_pThreadUsedObject->quit();
m_pThreadUsedObject->wait();
}
delete ui;
}
void MainWindow::dealValue()
{
int i = 0;
while (i < m_nMax) {
QThread::msleep(100);
++i;
emit emit_sendValue(i);
}
}
void MainWindow::on_btn_TimeConsumingOperation_clicked()
{
m_pDlgProgress->show();
// 0. 在主线程模拟处理耗时操作，界面卡死
// int i = 0;
// while (i < m_nMax) {
// QThread::msleep(100);
// ++i;
// emit emit_sendValue(i);
// }
/*********** 使用哪个，打开哪个注释 ***********/
// 1. 继承QThread
// m_pTread->start();
// 2. 继承QRunnable
// QThreadPool::globalInstance()->start(m_pThreadRunnable);
// 3. 继承QObject
// emit emit_start();
// 4. 使用QtConcurrent模块
// QtConcurrent::run(this, &MainWindow::dealValue);
}
3.6 结果
主界面显示：
点击耗时操作：
当进度走完，进度框关闭。
4 完整示例连接
链接: https://download.csdn.net/download/MrHHHHHH/88692241?spm=1001.2014.3001.5501
扫一扫
1526
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
