Qt实战案例（41）——利用QWinTaskbarButton和QWinTaskbarProgress类实现任务栏进度条的显示

一、项目介绍

任务栏进度条是Windows7就引入的一种UI形式，通常用于显示软件当前正在执行的任务的进度(如编译程序的进度、下载任务的进度)。如下：

本文主要介绍利用QWinTaskbarButton和QWinTaskbarProgress类实现任务栏进度条的显示。

二、项目基本配置

新建一个Qt案例，项目名称为“TaskbarTest”，基类选择“QWidget”，点击选中创建UI界面复选框，完成项目创建。

三、UI界面设置

UI界面如下，只有一个按钮PushButton：

四、主程序实现

4.1 pro文件

pro文件中需要增加一个库：

QT       += winextras

Qt框架针对Windows提供了一个单独的模块WinExtras。这个模块中提供了一些类库和函数，用于实现Windows上特有的功能，如类型转换、句柄操作、窗口属性设置等。当然也包括了此次我们要说的任务栏进度条，QWinTaskbarButton和QWinTaskbarProgress类。

4.2 widget.h头文件

声明计时器、任务栏按钮和进度指示器：

public:QTimer *timer;QWinTaskbarButton *windowsTaskbarButton;QWinTaskbarProgress *windowsTaskbarProgress;

声明定时器槽函数和按钮点击槽函数：

private slots:void onTimeout();void onButtonClicked();

4.3 widget.cpp源文件

在构造函数中编写代码如下：

    timer = new QTimer;timer->setInterval(10);//设置时间间隔为100mstimer->setSingleShot(false);//设置不是单次触发器windowsTaskbarButton = new QWinTaskbarButton(this);    //创建显示进度的任务栏按钮connect(timer, &QTimer::timeout, this, &Widget::onTimeout);//连接定时器信号和对应的槽函数connect(ui->pbn_start, &QPushButton::clicked, this, &Widget::onButtonClicked);//连接按钮点击信号和对应的槽函数

定义计时器对应的槽函数：

void Widget::onTimeout() {qDebug()<<windowsTaskbarProgress->value()+1;windowsTaskbarProgress->setValue(windowsTaskbarProgress->value() + 1);//设置TaskbarProgress的当前值windowsTaskbarProgress->show(); //显示TaskbarProgress//当达到最大值时则计时器停止且重置进度指示器if(windowsTaskbarProgress->value()==100){timer->stop();//计时器停止windowsTaskbarProgress->reset();//重置进度指示器}
}

定义按钮点击槽函数：

void Widget::onButtonClicked() {windowsTaskbarButton->setWindow(windowHandle());    //将任务栏按钮与进度条关联，假设进度条是它自己的窗口windowsTaskbarProgress = windowsTaskbarButton->progress();//设置进度指示器windowsTaskbarProgress->setRange(0, 100);   //设置最小值和最大值的值timer->start(); //定时器启动
}

五、效果演示

完整效果如下：

【注意】：这里有个坑，windowHandle()调用要在窗口显示出来之后才能返回正确的窗口句柄，否则返回的null，导致任务栏进度条无法正常显示。

如果没有看懂的话，完整代码可以参考：https://download.csdn.net/download/didi_ya/84404358

ok，以上便是本文的全部内容了，如果对你有所帮助，记得点个赞哟~

参考链接：https://forum.qt.io/topic/70672/windowhandle-will-return-null