十二、QProgressBar的简单使用与样式优化（Qt5 GUI系列）

一、设计需求

二、实现代码

三、代码解析

四、总结

五、扩展(自定义QProgressBar样式)

一、设计需求

在很多应用程序中，在执行费时操作时都会展示一个进度条来展示操作进行的进度。常见的场景，如：拷贝操作、安装操作以及卸载操作。本例要求实现进度条简单使用，同时实现模态与非模态的两种方式。

二、实现代码

#include "progressdlg.h"
#include <QApplication>int main(int argc, char *argv[])
{QApplication a(argc, argv);ProgressDlg w;w.show();return a.exec();
}

#ifndef PROGRESSDLG_H
#define PROGRESSDLG_H#include <QDialog>
#include <QLabel>
#include <QLineEdit>
#include <QProgressBar>
#include <QComboBox>
#include <QPushButton>
#include <QGridLayout>class ProgressDlg : public QDialog
{Q_OBJECTpublic:ProgressDlg(QWidget *parent = 0);~ProgressDlg();
private slots:void startProgress();
private:QLabel *FileNum;QLineEdit *FileNumLineEdit;QLabel *ProgressType;QComboBox *comboBox;QProgressBar *progressBar;QPushButton *starBtn;QGridLayout *mainLayout;
};#endif // PROGRESSDLG_H

#include "progressdlg.h"
#include <QProgressDialog>
#include <QFont>
ProgressDlg::ProgressDlg(QWidget *parent): QDialog(parent)
{//设置字体，标题QFont font("ZYSong18030",12);setFont(font);setWindowTitle(tr("Progress"));FileNum =new QLabel;FileNum->setText(tr("文件数目："));FileNumLineEdit =new QLineEdit;FileNumLineEdit->setText(tr("1000000"));//选择显示方式ProgressType =new QLabel;ProgressType->setText(tr("显示类型："));comboBox =new QComboBox;comboBox->addItem(tr("progressBar"));comboBox->addItem(tr("progressDialog"));progressBar =new QProgressBar;starBtn =new QPushButton();starBtn->setText(tr("开始"));mainLayout =new QGridLayout(this);mainLayout->addWidget(FileNum,0,0);mainLayout->addWidget(FileNumLineEdit,0,1);mainLayout->addWidget(ProgressType,1,0);mainLayout->addWidget(comboBox,1,1);mainLayout->addWidget(progressBar,2,0,1,2);mainLayout->addWidget(starBtn,3,1);//用于设置布局的边距mainLayout->setMargin(15);//用于设置布局中窗口部件之间的间距mainLayout->setSpacing(10);//建立联系connect(starBtn,SIGNAL(clicked()),this,SLOT(startProgress()));
}ProgressDlg::~ProgressDlg()
{}void ProgressDlg::startProgress()
{bool ok;//获取当前需要复制的文件数目，这里对应进度条的总步进值int num =FileNumLineEdit->text().toInt(&ok);if(comboBox->currentIndex()==0)                   //ProgressBar{progressBar->setRange(0,num);for(int i=1;i<num+1;i++){//QProgressBar的使用progressBar->setValue(i);}}else if(comboBox->currentIndex()==1)             //ProgressDialog{//新建一个QProgressDialog对象QProgressDialog *progressDialog=new QProgressDialog(this);QFont font("ZYSong18030",12);progressDialog->setFont(font);//设置进度对话框采用模态方式进行显示，即显示进度的同时，其他窗口将不响应输入信号progressDialog->setWindowModality(Qt::ApplicationModal);//设置进度对话框出现需等待的时间，此处设定为 5 秒，默认为 4 秒progressDialog->setMinimumDuration(5);progressDialog->setWindowTitle(tr("Please Wait"));progressDialog->setLabelText(tr("Copying..."));progressDialog->setCancelButtonText(tr("Cancel"));//设置进度对话框的步进范围//注意：当num为0时，如果进度条的值设置为0，此时进度条的状态时不稳定的，有时为空，有时为满。//因为此时的0即为最小值也为最大值progressDialog->setRange(0,num);for(int i=1;i<num+1;i++){progressDialog->setValue(i);//检测 "取消”按钮是否被触发，若触发则退出循环并关闭进度对话框if(progressDialog->wasCanceled())return;}}
}

效果展示：

三、代码解析

（1）setWindowModality函数

QWidget类中的setWindowModality()函数是用于设置窗口模态性的方法，可以用来控制窗口对于其他窗口的阻塞程度。

窗口模态性指的是窗口能否被其他窗口遮盖。在Qt中，有三种窗口模态性模式：

        Qt::NonModal：非模态窗口，不会阻塞其他窗口。
        Qt::WindowModal：应用程序模态窗口，阻塞其所属应用程序中的其他窗口，但允许与其他应用程序的窗口进行交互。
        Qt::ApplicationModal：系统模态窗口，阻塞其所属应用程序中的所有窗口，包括与其他应用程序的窗口之间的交互。

setWindowModality()函数的用法如下：

void QWidget::setWindowModality(Qt::WindowModality windowModality)

其中，windowModality是一个枚举类型，可以设置为Qt::NonModal、Qt::WindowModal或Qt::ApplicationModal中的任意一个值。

例如，将一个对话框设置为应用程序模态窗口可以这样做：

QDialog *dialog = new QDialog();
dialog->setWindowModality(Qt::WindowModal);
dialog->exec();

在上述代码中，QDialog对象dialog被设置为应用程序模态窗口，即在其打开状态下，所属应用程序中的其他窗口被阻塞，但它可以与其他应用程序的窗口进行交互。exec()函数用于显示对话框并进入模态运行，直到对话框被关闭。

需要注意的是，如果将一个窗口设置为模态窗口，则该窗口在显示期间将会阻塞其他事件的处理，包括其他窗口的事件，直到该模态窗口被关闭。因此，在设置窗口模态性时，应当谨慎使用，以免影响用户的操作体验。

四、总结

QProgressBar使用方法基本上就是上述的方法。但是用户可以自定义进度条的样式，来实现更加优秀的进度框。

五、扩展(自定义QProgressBar样式)

在Qt中，可以使用样式表（StyleSheet）来自定义QProgressBar的外观。QProgressBar有几个重要的样式属性可以用来自定义其外观：

                background-color：进度条的背景颜色。
                color：进度条的前景颜色（即进度条已完成部分的颜色）。
                selection-background-color：进度条的选中（已完成）部分的背景颜色。
                border-color：进度条的边框颜色。
                border-width：进度条的边框宽度。

以下是一个用样式表自定义QProgressBar外观的示例：

QProgressBar {background-color: pink;border: 1px solid black;border-radius: 5px;height: 20px;
}QProgressBar::chunk {background-color: green;width: 20px;margin: 1px;
}

在上述示例中，QProgressBar的背景颜色被设置为粉色，边框为黑色，圆角半径为5px，高度为20px。QProgressBar::chunk指定了进度条的前景颜色为绿色，宽度为20px，外边距为1px。

效果展示：