很好。现在进入 ProgressBar：阶段 2（教学总结）。

先给结论：
这一项表面上是在学 QProgressBar，但真正核心是 “时间驱动界面更新”。前几个模块大多是：

$$\text{用户操作} \rightarrow \text{界面变化}$$

而这一项开始变成：

$$\text{定时器触发} \rightarrow \text{界面变化}$$

也就是说，界面不再完全依赖用户每次点击，而是程序自己按时间节奏刷新。这是 Qt GUI 编程里非常重要的一步。

---

一、这个模块到底在学什么

这次可以拆成 4 层。

1. 显示层：QProgressBar

两个进度条分别显示：

• 一个从 0 增长到 100

• 一个从 100 减少到 0

所以这次不是单个控件显示值，而是两个控件一起呈现一个动态过程。

---

2. 驱动层：QTimer

进度条不会自己动，真正驱动它的是定时器。

也就是：

$$QTimer \xrightarrow{timeout} \text{更新进度条}$$

---

3. 状态层：内部计数 x

定时器每触发一次，内部状态 x 增加 1：

$$x = 0,1,2,\dots,100$$

然后：

• progressBar = x

• progressBar_2 = 100 - x

所以两个进度条实际上都在读同一个内部状态。

---

4. 控制层：启动 / 停止 / 复位

三个按钮的作用是：

• 启动：让时间开始流动

• 停止：暂停流动

• 复位：把界面显示恢复到初始状态

这说明 GUI 程序里常常会区分：

• 数据状态

• 时间驱动

• 用户控制命令

---

二、每个模块 / 函数的详细教学

下面按你要求，把这次出现的新模块、函数、机制逐个详细讲清楚。

---

A. QProgressBar 详细教学

A.1 它是什么

QProgressBar 是 Qt 的进度条控件，用于显示一个任务的完成程度。

典型场景：

• 文件下载进度

• 安装进度

• 训练进度

• 加载进度

• 数据处理进度

它最核心的思想是：

$$\text{把一个数值范围映射成可视化进度}$$

---

A.2 这次为什么用两个进度条

因为作业文档不是只想让你看“从 0 到 100”，而是想让你看到：

• 一个正向变化

• 一个反向变化

所以你这次实际上学到的是：

同一个内部状态可以驱动多个显示控件，以不同方式显示。

也就是：

$$x \rightarrow progressBar$$ $$x \rightarrow 100-x \rightarrow progressBar_2$$

---

A.3 最核心接口

1. setValue(int)

你这次最常用：

ui->progressBar->setValue(x);
ui->progressBar_2->setValue(100 - x);

它的作用是：

直接设置当前进度值

这是 QProgressBar 最核心的接口。

---

2. value()

可以读取当前进度值：

int v = ui->progressBar->value();

你这次没显式用，但以后做“继续进度”“同步标签显示”时很常用。

---

3. setRange(int min, int max)

设置进度条范围：

ui->progressBar->setRange(0, 100);

你这次主要是在 .ui 里设的最小值和最大值。
这一步非常重要，因为进度条显示的是“相对范围中的位置”，不是任意整数。

---

A.4 你现在应该形成的认识

以后只要遇到：

• 有“完成度”

• 有“百分比”

• 有“过程推进”

就应该优先想到 QProgressBar。

---

B. QTimer 详细教学

B.1 它是什么

QTimer 是 Qt 的定时器类。
它的作用是：

按一定时间间隔，周期性触发一个信号

这次你写的是：

my_timer = new QTimer(this);

这表示创建了一个定时器对象。

---

B.2 这次为什么必须用它

因为你不是想让进度条只在按钮点击时跳一下，而是要让它自动连续变化。

这就需要：

$$\text{每隔一段时间} \rightarrow \text{触发一次更新}$$

这正是 QTimer 的职责。

---

B.3 最核心接口

1. start(int msec)

启动定时器，并设置周期：

my_timer->start(100);

表示每 100 毫秒触发一次。

---

2. stop()

停止定时器：

my_timer->stop();

---

3. isActive()

判断定时器当前是否在运行：

if (my_timer->isActive() == false)

你这次在启动和停止按钮里都用到了。

---

B.4 这次你真正学到的是什么

你现在应该把 QTimer 理解成：

给 GUI 程序提供“节拍器”

它不是线程，不是 while 循环，不是 sleep。
它是基于 Qt 事件循环工作的“周期性触发器”。

也就是说：

$$\text{事件循环} + \text{QTimer} \Rightarrow \text{平滑周期更新}$$

---

C. timeout 详细教学

C.1 它是什么

timeout 是 QTimer 的核心信号。

含义是：

定时器到时间了

所以这句代码：

connect(my_timer, &QTimer::timeout, [=]{
    ...
});

表示：

• 每当定时器到点

• 就执行后面的处理逻辑

---

C.2 为什么它这么重要

因为 GUI 中很多“自动刷新”其实都来自这个信号，例如：

• 时钟每秒刷新一次

• 进度条每 100ms 更新一次

• 动画每帧更新一次

• 定时轮询任务状态

所以你以后看到“周期性更新”，就要想到：

$$QTimer::timeout$$

---

D. Lambda 匿名函数 详细教学

这次是你第一次在这些作业模块里明确遇到 Lambda 匿名函数。

你写的是：

connect(my_timer, &QTimer::timeout, [=]{
    static int x = 0;
    ...
});

---

D.1 它是什么

Lambda 是一种“就地定义的小函数”。

形式上：

[捕获列表](参数列表){
    函数体
}

你这次用的是：

[=]{
    ...
}

表示：

• 不显式写参数

• 以值捕获外部可访问变量

---

D.2 这次为什么用 Lambda

因为你这次的 timeout 逻辑很短，而且只在构造函数里用一次：

• 更新 x

• 改两个进度条

• 到终点时停止

如果专门再写一个单独槽函数，当然也可以，但会显得分散。
所以这里用 Lambda 很自然。

---

D.3 [=] 是什么

[=] 表示按值捕获外部变量。

在你这个例子里，Lambda 内部能访问：

• ui

• my_timer

• this 所在对象上下文中的可见内容

这让你能直接在匿名函数里写：

ui->progressBar->setValue(x);
my_timer->stop();

---

D.4 什么时候适合 Lambda

适合：

• 逻辑短

• 只在本地使用一次

• 不值得专门写一个槽函数

不太适合：

• 很长的业务逻辑

• 需要复用

• 需要单独测试或复查的复杂功能

---

E. static int x 详细教学

这次这是最关键的新机制之一。

你写的是：

static int x = 0;

---

E.1 它是什么

这里的 static 表示：

这个局部变量只初始化一次，并且在函数多次调用之间保留上次的值

也就是说，它虽然写在 Lambda 内部，但不是每次都重新从 0 开始。

---

E.2 为什么这次必须是 static

因为 timeout 每 100ms 都会触发一次。
如果你写成普通局部变量：

int x = 0;

那么每次一进入 Lambda，x 都会重新变成 0，进度条就永远只会显示 1。

而 static int x = 0; 的效果是：

第一次调用：

$$x=0 \rightarrow x=1$$

第二次调用：

$$x=1 \rightarrow x=2$$

……

直到：

$$x=100$$

所以它承担的是“跨调用保存状态”的作用。

---

E.3 这次它的角色是什么

它本质上是：

进度动画的内部计数器

然后两个进度条都由它派生出来：

$$progressBar = x$$ $$progressBar_2 = 100-x$$

---

E.4 这也是文档版本里一个隐藏问题的来源

因为 x 是写在 Lambda 里的 static 局部变量，所以：

• 你点击“复位”按钮时，只改了进度条显示值

• 但并没有改这个 x

于是就会出现一个逻辑上的不严谨点：

界面看起来复位了，但内部计数器可能没复位

这就是我在实现阶段提前提醒你的那个点。

---

F. on_pushButton_clicked() 详细教学

这是“启动”按钮槽函数。

void MainWindow::on_pushButton_clicked()
{
    if (my_timer->isActive() == false)
    {
        my_timer->start(100);
    }
}

---

F.1 它在做什么

它不是直接改进度条，而是：

开启时间驱动机制

这点很重要。
也就是说按钮只是发出命令，真正让进度动起来的是定时器。

---

F.2 为什么先判断 isActive()

因为如果定时器已经启动，再反复启动没有意义。
所以这里先判断：

$$\text{若当前没运行} \rightarrow \text{再启动}$$

这属于一种基本的防御式写法。

---

G. on_pushButton_2_clicked() 详细教学

这是“停止”按钮槽函数。

void MainWindow::on_pushButton_2_clicked()
{
    if (my_timer->isActive() == true)
    {
        my_timer->stop();
    }
}

---

G.1 它在做什么

和启动相反，它负责：

暂停时间驱动更新

因此它不是“把进度清零”，只是“冻结当前状态”。

---

G.2 为什么这很重要

这说明你要开始区分三类操作：

• 启动：开始变化

• 停止：暂停变化

• 复位：恢复初始显示

它们不是同一件事。

---

H. on_pushButton_3_clicked() 详细教学

这是“复位”按钮槽函数。

void MainWindow::on_pushButton_3_clicked()
{
    ui->progressBar->setValue(0);
    ui->progressBar_2->setValue(100);
}

---

H.1 它在做什么

它只是把显示层恢复了：

• 第一个进度条显示 0

• 第二个进度条显示 100

---

H.2 为什么说它“不够严谨”

因为它没有同步恢复内部状态 x。

所以这次你必须明确一个很重要的区分：

$$\text{显示复位} \neq \text{内部状态复位}$$

这也是这节最值得你像审稿人一样看出来的问题。

---

三、本模块新增模块的重点系统总结

下面把这次新出现的内容系统总结一遍。

---

1. QProgressBar

定义

进度条控件，用于显示某个过程在给定范围内的进展程度

适合场景

• 下载

• 训练

• 处理流程

• 安装

• 加载

常用接口

• setValue(int)

• value()

• setRange(int, int)

本次作用

显示一个正向进度和一个反向进度

---

2. QTimer

定义

定时器类，用于周期性触发信号

常用接口

• start(int msec)

• stop()

• isActive()

核心信号

• timeout

本次作用

每 100ms 触发一次界面更新

---

3. timeout

定义

定时器到点时发出的信号

本次作用

作为两个进度条自动变化的触发器

---

4. Lambda 匿名函数

定义

就地编写的一次性小函数

本次形式

[=]{
    ...
}

本次作用

直接在构造函数里写定时器响应逻辑，不再额外拆槽函数

---

5. static int x

定义

只初始化一次、跨多次调用保留值的局部变量

本次作用

充当内部计数器，让进度在多次 timeout 之间持续增长

重要副作用

如果只改进度条显示、不改它，复位逻辑就不完整

---

四、这个模块最重要的知识点

1. 进度条本质上显示的是“状态值”

不是自己会动，而是程序不断给它新值。

---

2. 定时器是 GUI 中“自动更新”的核心工具

你现在正式进入了“时间驱动 UI”的阶段。

---

3. Lambda 适合短小的一次性逻辑

这次非常适合用它。

---

4. static 局部变量能跨调用保存状态

这是这节最关键的 C++ 语言点之一。

---

5. 要区分“显示状态”和“内部状态”

这节最大的设计漏洞就出在这两者没一起复位。

---

五、这个模块最容易踩的坑

易错点 1：把 QTimer 当线程

不是。
它是基于事件循环的定时触发器，不会自动开新线程。

---

易错点 2：忘记 static

如果 x 不是 static，进度条就不会持续增长。

---

易错点 3：以为“复位按钮”已经完整复位

其实文档版本没有真正复位内部 x。
这是本模块最大的隐藏问题。

---

易错点 4：在定时器已运行时反复 start()

虽然不一定直接出错，但逻辑上不干净，所以先用 isActive() 判断是合理的。

---

六、这个模块更稳的改法（你现在知道即可）

虽然你已经按文档跑通，但从代码质量上说，更稳的写法是：

• 不把 x 写成 Lambda 内的 static

• 而是写成 MainWindow 的成员变量，例如 int m_progress = 0;

这样“复位按钮”就能同时改显示和内部状态。
你现在先记住这个审稿式判断，后面自己写程序时要尽量这样改。

---

七、你现在应该形成的理解

做完这个模块，你应该明确：

1. QProgressBar 是显示控件，不是驱动控件

2. QTimer 是自动更新机制的核心

3. timeout 是时间节拍信号

4. Lambda 能把短小逻辑就地写在 connect() 里

5. static 局部变量可以跨调用保存状态

6. GUI 程序里要时刻分清“界面显示”和“内部状态”

---

八、这一模块最值得记住的最小模板

你最值得记住的是这段：

my_timer = new QTimer(this);

connect(my_timer, &QTimer::timeout, [=]{
    static int x = 0;

    if (x != 100)
    {
        x++;
        ui->progressBar->setValue(x);
        ui->progressBar_2->setValue(100 - x);
    }
    else
    {
        x = 0;
        my_timer->stop();
    }
});

它代表的是：

$$QTimer \rightarrow timeout \rightarrow 内部状态更新 \rightarrow 多控件刷新$$

以及这段：

void MainWindow::on_pushButton_clicked()
{
    if (!my_timer->isActive())
    {
        my_timer->start(100);
    }
}

它代表：

$$用户命令 \rightarrow 启动时间驱动$$

---

下一步按新流程，应该进入 DateTimeEdit 阶段 1：实现 + 运行验证。