本章重要 API 函数#

💡 Tips：本篇 connect(btn, &QPushButton::clicked, this, &KeyPad::lcd_show) 是”多对一”连接——12 个按钮连同一个槽，靠 sender() 区分是谁被点。这种写法方便，但 sender() 只在直接连接（同线程默认）时可靠；跨线程队列连接时 sender() 可能为 nullptr，那时应改用带参数的 Lambda 把 num 绑进捕获列表。

本章目录#

点击条目可跳转到对应小节。

学习前后依赖#

💡 Tips：本篇是第 13 篇的”实战落地”——第 13 篇的 A/B 是抽象演示，本篇把发送者换成了 12 个真实 QPushButton。先吃透第 13 篇的 connect 语法，本篇就只是”把信号源从自定义类换成内置控件”，理解毫无障碍。

1. 概述#

qt14_tst-key_pad 是一个仿手机拨号盘：上方 QLCDNumber 显示数字，下方 4×3 网格排布 12 个按钮（1–9、删除、0、确定）。点击数字键向 LCD 追加一位；“删除”键相当于除以 10 退一位；“确定”键清零并触发 random_keypad() 把数字键打乱重排（删除/确定键位置固定）。

它的价值在于展示一个 GUI 设计套路：用一张静态按钮表 + 一个统一槽函数，而不是为每个按钮写 12 个独立槽。这让”随机打乱布局”变得简单——按钮是固定对象，只是改变它们被 addWidget 进网格的行列位置。

💡 Tips：记住一句话——布局（layout）决定”在哪”，按钮对象决定”是什么”，信号槽决定”点了干嘛”。本工程把所有按钮预先 new 出来存进 btns 列表，打乱时只是重新 addWidget，按钮本身不被销毁重建，因此它们的 connect 依然有效。

2. 核心概念 / 原理#

整个面板建立在三个支柱上：

1. UI 文件分离：keypad.ui 用 Qt Designer 描述界面（一个 QLCDNumber 名为 lcdNumber，一个容器 QWidget 名为 padWeight 作为网格的父）。uic 把它编译成 ui_keypad.h，setupUi 把控件实例化并挂到 this 上。
2. 网格布局：QGridLayout *pad_layout = new QGridLayout(ui->padWeight)；之后 addWidget(btn, i, j, 1, 1) 把第 i*3+j 个按钮放进第 i 行第 j 列。setContentsMargins(0,0,0,0) 和 setSpacing(0) 做出无间隙的整块键盘外观。
3. 属性标记 + 统一槽：每个按钮 setProperty("num", key_buttons[i].num) 记住自己的语义（数字 / 删除=10 / 确定=11）。所有按钮 connect(..., &KeyPad::lcd_show)，lcd_show 内用 sender() 取回按钮、读 property("num") 决定行为。

1
// 关键数据：按钮文字 + 语义编号
2
static QList<Key_info> key_buttons = {
3
    {"1",1},{"2",2},{"3",3},{"4",4},{"5",5},{"6",6},
4
    {"7",7},{"8",8},{"9",9},{"删除",10},{"0",0},{"确定",11}
5
};

💡 Tips：原理上最易混淆的是 QGridLayout 的行列索引从 0 开始、先行后列。本项目 4 行 3 列，所以 pos = i*3+j 把一维 key_buttons 索引映射到二维网格。另外 ui->padWeight 是 native="true" 的普通 QWidget，专门充当布局的”画布”——直接把按钮 new 到它上面并交给网格管理。

3. 信号槽将 12 个按键接入逻辑的机制#

下面用流程图展示”点击任意按钮 → 统一槽 → 按属性分流”的完整链路：

💡 Tips：流程里最关键的节点是 sender() → property("num") 这一段——它是”多对一槽”能区分来源的核心技巧。注意 lcd_show 开头的防御：if (btn==nullptr) return;——若槽被非按钮来源（或跨线程）触发，sender() 转换失败就安全退出，避免空指针崩溃。

4. 核心代码解析#

1
KeyPad::KeyPad(QWidget *parent) : QWidget(parent), ui(new Ui::KeyPad) {
2
    ui->setupUi(this);
3
    pad_layout = new QGridLayout(ui->padWeight);
4
    pad_layout->setContentsMargins(0,0,0,0);
5
    pad_layout->setSpacing(0);
6
    QPushButton *btn;
7
    for(int i=0;i<key_buttons.size();i++) {
8
        btn = new QPushButton(key_buttons[i].text, ui->padWeight);
9
        btn->setProperty("num", key_buttons[i].num);
10
        btn->setMinimumSize(80,80); btn->setMaximumSize(80,80);
11
        if (i==9 || i==11) btn->setStyleSheet(/* 橙色：删除/确定 */);
12
        else               btn->setStyleSheet(/* 灰色：数字键 */);
13
        btns.append(btn);
14
    }
15
    fixed_keypad();   // 把按钮按固定顺序摆进网格并联信号
16
}

1
void KeyPad::fixed_keypad() {
2
    for(int i=0;i<4;i++)
3
        for(int j=0;j<3;j++) {
4
            auto btn = btns[i*3+j];
5
            pad_layout->addWidget(btn, i, j, 1, 1);
6
            connect(btn, &QPushButton::clicked, this, &KeyPad::lcd_show);
7
        }
8
}

1
void KeyPad::lcd_show() {
2
    auto btn = qobject_cast<QPushButton*>(sender());
3
    if (btn==nullptr) return;
4
    int lcd_value = ui->lcdNumber->intValue();
5
    int num = btn->property("num").toInt();
6
    qDebug() << "lcd_show:" << num;
7
    if (num == 10) {                       // 删除
8
        if(cnt<=0) return;
9
        lcd_value/=10; ui->lcdNumber->display(lcd_value); --cnt;
10
    } else if (num == 11) {                // 确定
11
        ui->lcdNumber->display(0);
12
        random_keypad(); cnt=0;
13
    } else {                               // 数字
14
        lcd_value = num + lcd_value*10;
15
        ui->lcdNumber->display(lcd_value); ++cnt;
16
    }
17
}

5. 运行效果 / 验证#

运行后窗口显示 240×400 的拨号盘：顶部 LCD，下方 4×3 暗色键盘。验证清单：

1. 依次点 1、2、3 → LCD 依次显示 1、12、123（lcd=num+lcd*10）。
2. 点”删除” → 123 变 12，再点变 1，到 0 后不再除（被 cnt<=0 拦截）。
3. 点”确定” → LCD 清零，且数字键位置被打乱；再点数字仍能正确输入，证明按钮身份未变。
4. 控制台输出每点的 lcd_show: <num>，与按钮语义一致。

💡 Tips：验证时容易误判”成功”的假象——若 LCD 不更新，先确认 connect 是否真的执行（断点或 qDebug 进 lcd_show）；若 sender() 转换失败，说明槽被非按钮触发或连接类型异常。另外 .ui 改过名字但没重新生成 ui_keypad.h 时界面会是空白——Qt Creator 通常会自动重跑 uic，但命令行构建要确认构建步骤包含 uic。

容易踩坑（注意点）#

• 坑 1：按钮 new 出来却没设父、也没进布局 → 不显示或内存泄漏。规避：始终 new QPushButton(text, ui->padWeight) 设父，并用 addWidget 纳入布局。
• 坑 2：sender() 返回 nullptr 导致 property 崩溃 → 槽被非按钮或跨线程触发。规避：坚持 qobject_cast 后判空；跨线程改用 Lambda 捕获 num。
• 坑 3：.ui 里控件改名后 C++ 引用没改 → 编译期 ui->xxx 报错或运行空指针。规避：Designer 改名后同步更新 .cpp 中的 ui-> 成员名（uic 生成的成员名随 ui 名变化）。
• 坑 4：布局边距/间距没清零，键盘出现缝隙 → 视觉不整。规避：setContentsMargins(0,0,0,0) 与 setSpacing(0)。
• 坑 5：多次调用 fixed_keypad/random_keypad 重复 addWidget → 同一按钮被加两次。规避：本项目按钮只建一次、只连一次，打乱仅改行列位置，本身安全；自定义时若要重排应先 removeWidget 再 addWidget。
• 坑 6：忘记 Q_OBJECT 与 moc → lcd_show 作槽无效。规避：KeyPad 类已带 Q_OBJECT，用 qt_add_executable 把 keypad.h/.cpp/.ui 都列入源，CMake 自动处理 uic/moc。

学习要点总结#

Q&A（常见问题）#

Q1：sender() 到底安不安全？什么时候会失效？ A1：仅在同线程、直接连接时可靠（本工程正是如此）。若信号槽跨线程使用 Qt::QueuedConnection，槽在接收者线程的事件循环里执行，此时 sender() 返回 nullptr。更安全的替代是连接时用 Lambda 把 num 捕获进去：connect(btn, &QPushButton::clicked, this, [this, num]{ ... });，彻底摆脱 sender()。

Q2：为什么不用 12 个独立槽函数？ A2：可以用，但会产生大量重复代码且不利于”随机打乱”（打乱只需改布局，逻辑不变）。统一槽 + 属性标记让”行为”与”按钮身份”解耦，是更符合 Qt 风格的写法。当按钮数量动态变化时，这种套路扩展性也更好。

Q3：Qt5/Qt6 在 .ui 与布局上有差异吗？ A3：基本无差异。uic 生成的 ui_*.h 在 Qt5/Qt6 用法一致；qt_add_executable 会自动调用 uic 处理 .ui，无需手写 qt_wrap_ui。注意 Qt6 默认要求 C++17，且 QOverload 等现代写法更顺手。本项目 CMakeLists.txt 用 find_package(Qt6 6.5 ...)，是典型的 Qt6 配置。

Q4：random_keypad 里 btns[pos] 对 9/11 不洗牌，为何？ A4：因为删除(9)、确定(11)两个功能键位置固定（始终在右下两格），所以 std::shuffle 只对 i!=9 && i!=11 的数字键索引洗牌，摆放时这两格直接取原按钮，其余按洗牌后的 indexs 取——实现”数字乱序、功能键不动”的效果。

Tips（全局速记）#