很好。现在进入 SpinBox 数值组件：阶段 2（教学总结）。

先给结论：
这个模块表面上是在学 QSpinBox，但真正要掌握的是一条更重要的 Qt 交互链：

$$\text{数值输入控件} \rightarrow \text{信号发射} \rightarrow \text{槽函数计算} \rightarrow \text{结果控件更新}$$

你的这个案例已经包含了这条链的完整最小实现：

• QSpinBox / QDoubleSpinBox：输入与显示数值

• valueChanged(...)：当值变化时自动发信号

• on_pushButton_clicked()：统一作为计算槽

• setValue() / setNum()：把结果同步到界面

文档中对这一案例的两种实现都写得很明确：既可以点击按钮手动计算，也可以通过 valueChanged() 自动完成计算；示例中使用了 spinBox、spinBox_2、doubleSpinBox、label_10，并在数值变化时调用同一个槽函数。

---

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

这次你学到的不是“一个控件怎么摆上去”，而是 Qt 中最典型的实时联动模式。

1. 输入

两个整数输入框：

• ui->spinBox

• ui->spinBox_2

它们负责提供两个整数值。

---

2. 触发

当输入值变化时：

connect(ui->spinBox, SIGNAL(valueChanged(int)),
        this, SLOT(on_pushButton_clicked()));

这表示：

• spinBox 的值一变

• 就立刻触发计算槽

也就是说，这不是“等用户点提交”，而是实时响应式界面。
文档自动计算版就是这么设计的。

---

3. 计算

统一在槽函数里完成：

int x = ui->spinBox->value();
int y = ui->spinBox_2->value();
double total = static_cast<double>(x + y);

这一步就是业务逻辑层。

---

4. 输出

结果被同步写回两个控件：

ui->doubleSpinBox->setValue(total);
ui->label_10->setNum(total);

于是你同时得到：

• 数值型结果显示

• 文本型结果显示

这正是“一个输入，多个输出”的最小例子。

---

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

下面按你要求，对这次出现的每个重要模块、函数做详细讲解。

---

A. QSpinBox 详细教学

A.1 它是什么

QSpinBox 是 Qt 的整数步进输入控件。

它本质上是一个“带上下箭头的整数输入框”，用户可以：

• 直接键盘输入数字

• 点击上下箭头增减

• 使用鼠标滚轮调整

它适合处理：

• 数量

• 页码

• 次数

• 年龄

• 分值

• 任何整数型参数

在 Qt 6 参考教材里，QSpinBox 和 QDoubleSpinBox 是一组常见数值输入组件，并专门有小节讲它们的属性和示例。

---

A.2 最核心接口

1. value()

读取当前整数值：

int x = ui->spinBox->value();

这是它最核心的接口。

---

2. setValue(int)

设置当前值：

ui->spinBox->setValue(10);

如果你后面做“重置按钮”，这个接口会很常用。

---

3. setMinimum(int) / setMaximum(int)

限制输入范围：

ui->spinBox->setMinimum(0);
ui->spinBox->setMaximum(100);

也可以直接用：

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

---

4. setSingleStep(int)

设置每次点击箭头时增减多少：

ui->spinBox->setSingleStep(5);

默认通常是 1。

---

5. valueChanged(int)

这是最重要的信号之一。
只要值变化，它就会自动发出信号。

这也是这次自动求和能成立的关键。

---

A.3 这次你为什么用它

因为这次的输入是“两个整数相加”。

所以 QSpinBox 很合适：

• 输入安全，不会乱输字符串

• 自动限制范围

• 取值直接就是 int

• 不需要再做 QString -> int 转换

相比 QLineEdit，它更适合“数值已知、范围可控”的场景。

---

A.4 和 QLineEdit 的区别

这是一个很重要的控件选择问题。

QLineEdit

适合：

• 文本输入

• 用户名

• 密码

• 自由格式字符串

• 不确定内容

QSpinBox

适合：

• 整数输入

• 有上下界

• 有步长

• 不希望用户输非法字符

所以你要形成一个判断：

• “我要一段文本” → QLineEdit

• “我要一个整数参数” → QSpinBox

---

B. QDoubleSpinBox 详细教学

B.1 它是什么

QDoubleSpinBox 是 QSpinBox 的浮点数版本。
也就是：

$$\text{整数数值框} \rightarrow \text{浮点数数值框}$$

适合处理：

• 小数

• 金额

• 温度

• 比例

• 浮点结果显示

---

B.2 这次为什么用了它

虽然这次加法结果本质上还是整数，但结果框使用 QDoubleSpinBox 有两个教学目的：

1. 让你认识浮点数值控件；

2. 为后面更复杂的数值计算做铺垫。

文档示例中确实是把结果显示到 doubleSpinBox。

---

B.3 最核心接口

1. setValue(double)

ui->doubleSpinBox->setValue(total);

2. value()

double z = ui->doubleSpinBox->value();

3. setDecimals(int)

设置保留几位小数：

ui->doubleSpinBox->setDecimals(2);

4. setRange(double, double)

设置范围：

ui->doubleSpinBox->setRange(-1000.0, 1000.0);

5. valueChanged(double)

它发出的信号参数类型是 double，这和 QSpinBox 的 int 不同。

---

B.4 为什么这次禁用它还能 setValue()

这是初学者很容易困惑的一点。

你用了：

ui->doubleSpinBox->setEnabled(false);

这表示：

• 用户不能操作它

• 但程序仍然可以改它的值

所以：

ui->doubleSpinBox->setValue(total);

仍然完全合法。

文档原示例也是这样处理结果框的：把它禁用，作为只显示结果的输出控件。

这其实体现了一个重要原则：

$$\text{禁用用户交互} \ne \text{禁止程序写入}$$

---

C. QLabel 与 setNum() 详细教学

C.1 这次它扮演什么角色

label_10 是一个纯文本输出控件。
它不像 doubleSpinBox 那样保留“数值控件属性”，它只是把结果显示成文本。

---

C.2 setNum() 是什么

你写的是：

ui->label_10->setNum(total);

setNum() 的作用是：

• 接收一个数字

• 自动把数字转成字符串

• 再显示到标签上

等价于你手动写：

ui->label_10->setText(QString::number(total));

所以它是一个更方便的简写。

---

C.3 为什么这次同时用 doubleSpinBox 和 QLabel

这是一个教学设计点。

同一个结果：

• 放到 doubleSpinBox：你看到“数值控件也能做输出”

• 放到 QLabel：你看到“文本控件也能做输出”

也就是说，这次模块其实在教你：

$$\text{一个业务结果可以绑定到多个不同类型的显示控件}$$

---

D. connect() 详细教学

D.1 它是什么

connect() 是 Qt 里连接信号和槽的核心函数。

这次你用的是旧语法：

connect(ui->spinBox, SIGNAL(valueChanged(int)),
        this, SLOT(on_pushButton_clicked()));

表示：

• 发送者：ui->spinBox

• 信号：valueChanged(int)

• 接收者：this

• 槽：on_pushButton_clicked()

也就是：

$$\text{spinBox值变化} \rightarrow \text{调用当前窗口的计算函数}$$

Qt 对象模型课程内容中，信号和槽就是对象通信的核心机制，这也是 Qt 最重要的区别性特征之一。

---

D.2 为什么两个输入框连到同一个槽

你这次做的是：

connect(ui->spinBox, SIGNAL(valueChanged(int)),
        this, SLOT(on_pushButton_clicked()));

connect(ui->spinBox_2, SIGNAL(valueChanged(int)),
        this, SLOT(on_pushButton_clicked()));

这是 Qt 里很典型的模式：

• 多个输入源

• 共用一个处理逻辑

因为无论哪个输入框变化，最后都要重新计算总和。
所以让它们共用同一个槽是完全合理的。

---

D.3 为什么不建议把 doubleSpinBox 也连进去

文档给出的自动计算版还写了：

QObject::connect(ui->doubleSpinBox,SIGNAL(valueChanged(double)),this,SLOT(on_pushButton_clicked()));

这句我让你删掉，是有原因的。

因为在槽函数里你又会：

ui->doubleSpinBox->setValue(total);

这会再次触发 doubleSpinBox 的 valueChanged(double)，导致不必要的重复调用。

虽然不一定无限递归，但设计上是多余的。
这属于“程序可能跑得通，但连接图不干净”。

这正是你希望我指出的那种“影响理解和复现质量的问题”。

---

E. valueChanged(...) 详细教学

E.1 它是什么

这是数值控件最关键的一类信号。
它表示：

当前值发生变化

对于不同控件，参数类型不同：

• QSpinBox：valueChanged(int)

• QDoubleSpinBox：valueChanged(double)

---

E.2 这次为什么它这么重要

因为这次你做的是自动计算版，不是按钮提交版。

所以真正的触发器不是按钮，而是：

$$\text{值变化信号}$$

这意味着你的程序已经具备了“响应式 GUI”雏形。

---

E.3 什么时候适合用它

适合：

• 拖动滑块就刷新结果

• 调整数值就更新标签

• 改变步进框值就实时绘图

• 改参数就自动重算公式

也就是说，只要你不想让用户“每次都按提交”，就很可能会用到它。

---

F. on_pushButton_clicked() 这个槽函数详细教学

这次虽然函数名看起来像“按钮点击”，但它实际上已经变成了统一计算入口。

你的函数核心逻辑是：

void MainWindow::on_pushButton_clicked()
{
    int x = ui->spinBox->value();
    int y = ui->spinBox_2->value();

    double total = static_cast<double>(x + y);

    ui->doubleSpinBox->setValue(total);
    ui->label_10->setNum(total);
}

---

F.1 它现在承担了两个触发来源

这个槽会被两类动作触发：

1. 用户点击按钮

2. 用户修改 SpinBox 数值

也就是说，它已经不是“按钮专属函数”，而是：

$$\text{统一业务处理函数}$$

这在 Qt 设计里很常见：
槽函数名可能来自最初绑定对象，但后来会承接更广的业务职责。

---

F.2 为什么这种写法是合理的

因为你这次计算逻辑非常单纯：

• 读取两个值

• 求和

• 刷新输出

所以让按钮点击和数值变化都走这一个函数，代码最少、逻辑最集中。

---

F.3 再进一步的更好写法

如果以后你想把结构再整理得更好，可以把业务逻辑单独抽出来：

void MainWindow::updateTotal()
{
    int x = ui->spinBox->value();
    int y = ui->spinBox_2->value();
    double total = static_cast<double>(x + y);

    ui->doubleSpinBox->setValue(total);
    ui->label_10->setNum(total);
}

然后：

void MainWindow::on_pushButton_clicked()
{
    updateTotal();
}

这样语义更清楚。
但在你当前课程阶段，先保持简单完全没问题。

---

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

1. 数值控件优先于文本控件

如果输入本来就是“整数参数”，优先用 QSpinBox，不要再用 QLineEdit 再自己转型。

这是控件选型意识。

---

2. 信号驱动实时联动

你已经开始接触真正的 Qt 编程核心：

$$\text{用户动作} \rightarrow \text{信号} \rightarrow \text{槽} \rightarrow \text{界面更新}$$

这比“写一个 if-else 按按钮执行”更接近真实 GUI 开发。

---

3. 一个结果可以输出到多个控件

同一个 total 被同步输出到：

• doubleSpinBox

• label_10

这说明 GUI 中“显示形式”和“数据来源”是可以分离的。

---

4. 禁用控件不等于不能被程序更新

setEnabled(false) 只是禁止用户交互，不影响程序赋值。

这个点你后面会反复用到。

---

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

易错点 1：忘记在 .h 里声明槽函数

你这次已经踩到了：

void MainWindow::on_pushButton_clicked()

如果 mainwindow.h 里没有声明，就会报：

$$\text{no declaration matches}$$

这说明你必须形成一个固定检查习惯：

• .cpp 里实现了成员函数

• .h 里必须先声明

---

易错点 2：对象名和槽函数名不匹配

自动连接要求非常严格：

• 对象名：pushButton

• 槽函数名：on_pushButton_clicked

少一个字母都不行。

---

易错点 3：把结果框也连进 valueChanged

这是设计上最容易“看起来没错、其实多余”的地方。
我已经在实现阶段帮你规避了。

---

易错点 4：误以为 label_10->setNum() 只能显示整数

其实它也可以显示浮点数，只是格式控制不如 QString::number() 灵活。
如果你后面需要控制小数位，建议改用：

ui->label_10->setText(QString::number(total, 'f', 2));

---

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

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

1. QSpinBox 是“安全整数输入控件”

2. QDoubleSpinBox 是“浮点数值控件”

3. valueChanged(...) 是数值控件实时联动的核心信号

4. connect() 允许多个输入源指向同一个槽

5. 一个槽函数可以同时被按钮点击和数值变化触发

6. 输出结果可以同时写入多个不同类型控件

---

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

把下面这段理解透，后面很多联动题都会很简单：

connect(ui->spinBox, SIGNAL(valueChanged(int)),
        this, SLOT(on_pushButton_clicked()));

connect(ui->spinBox_2, SIGNAL(valueChanged(int)),
        this, SLOT(on_pushButton_clicked()));

void MainWindow::on_pushButton_clicked()
{
    int x = ui->spinBox->value();
    int y = ui->spinBox_2->value();

    double total = static_cast<double>(x + y);

    ui->doubleSpinBox->setValue(total);
    ui->label_10->setNum(total);
}

这段模板背后的抽象结构是：

$$\text{输入变化} \rightarrow \text{触发计算} \rightarrow \text{多位置显示结果}$$

---

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