# 简易计算器 —— Qt Designer 表单对照版

> 对应教案 [`OUTLINE_4DAY.md`](../../OUTLINE_4DAY.md) Day2 下午「项目案例：简易
> 计算器」。与 [`../calculator/`](../calculator/README.md)（纯代码 `QGridLayout`
> 版）对照阅读：**界面搭建方式换了，业务逻辑一字不差**——`onDigit`/`onOperator`/
> `onEquals`/`onClear`/`onBackspace`/`compute` 全部照搬。手工维护，非生成产物。

## 与代码版的唯一区别：界面从哪来

| | 代码版 `qt_calculator.cpp` | Designer 版 `qt_calculator_designer.cpp` |
|---|---|---|
| 控件树+布局 | `buildKeypad()` 手写 `new QPushButton` + `QGridLayout::addWidget` | `calculator_designer.ui`（Designer 表单 XML）+ `uic` 编译期生成 `ui_calculator_designer.h` + `setupUi(this)` 一次建好 |
| 找控件 | 局部变量/成员指针 | `ui->btn7`、`ui->display` ……（objectName 对应成员名） |
| 构建开关 | `AUTOMOC ON` | `AUTOMOC ON` **+ `AUTOUIC ON`**（CMake 自动跑 `uic`） |
| 业务逻辑 | 状态机 | 完全相同 |

## ★ 新增知识点：Designer 表单的「自动连接」

`ui->setupUi(this)` 内部会调用 `QMetaObject::connectSlotsByName(this)`：只要
类里有名为 `on_<objectName>_<signal>()` 的槽（比如 `on_btnClear_clicked()`），
Qt 会**自动**把表单里 `objectName` 为 `btnClear` 的控件的 `clicked()` 信号连上去，
不需要手写 `connect()`。这是信号槽的第三种写法（前两种见 `../calculator/`）。

**本示例故意不用这个自动连接**，全部改成显式 `connect()`——原因是当天的坑卡：

- 坑：表单里把按钮 `objectName` 从 `btnClear` 改成 `btnReset`，`on_btnClear_clicked()`
  这个槽**不报编译错误、不报运行时错误**，只是从此再也不会被调用——`connectSlotsByName`
  找不到匹配的 `objectName` 时只是静默跳过。这是「静默失败」坑点家族的第三个成员
  （前两个是旧 `SIGNAL()/SLOT()` 字符串语法、重复 `connect`）。
- 结论：显式 `connect()` 虽然多写几行，但改名/删控件时编译器/IDE 能帮你追踪引用，
  排查成本远低于依赖命名约定的隐式连接。项目里**推荐显式 connect**，`on_xxx_yyy()`
  自动连接更适合 Qt Designer 快速原型阶段。

## 验证方式（自测模式）

```bash
QT_QPA_PLATFORM=offscreen tools/run_qt.sh qt_calculator_designer
# 自测用例与 ../calculator/ 完全一致：「7+3=10」「6÷0=Error」「4.5+0.5=5」
# 「12 退格→1」「2+3+4=9（链式运算）」，全部通过退出码 0
tools/run_qt.sh qt_calculator_designer    # 有 X 环境：完整交互
```

## 课堂讲解建议

1. 先展示 `.ui` 文件本身是纯 XML（`<widget class="QPushButton" name="btn7">…`）——
   Qt Designer 只是这份 XML 的图形化编辑器，不是什么黑魔法；
2. 对照 `../calculator/qt_calculator.cpp` 的 `buildKeypad()`，逐行说明
   `uic` 把这份 XML 翻译成了等价的 C++ 建控件代码（`build/` 里能翻出真实生成的
   `ui_calculator_designer.h` 验证）；
3. 演示自动连接的坑：把 `.ui` 里某个按钮的 `name` 改掉，重新构建，点击按钮
   没反应——现场复现「改名静默失效」；
4. 讨论：两种方式怎么选？—— 快速原型/美术同学调界面用 Designer 更直观；
   逻辑复杂、控件数量随数据动态变化（比如 Day5 的表格行）就必须手写代码搭建，
   `.ui` 表单描述不了「运行时循环创建 N 个控件」。

## 参考

- 代码布局对照版：[`../calculator/`](../calculator/README.md)
- Qt 官方 Widgets 表单机制：`uic`（User Interface Compiler）+ `QMetaObject::connectSlotsByName`
