Qt核心机制:信号与槽详解

一、基本概念

  上一篇我们用 connect实现了按钮点击的效果,这一篇系统地讲讲 Qt 中最核心的机制:信号与槽。

1.1 Linux 信号 与 Qt 信号

  Linux系统中也有"信号"这个概念,它是系统内部的通知机制 (或者说一种通信方式)。在 Linux 中会关注三个点:信号源、信号类型、信号处理方式。

  Qt 中的信号和 Linux 中的信号不是同一个概念,但有类似的地方,同样涉及这三要素:

三要素 Linux 信号 Qt 信号
信号源 键盘、内核、kill命令等 各种控件(按钮、输入框等)
信号类型 SIGINT、SIGSEGV等 点击、勾选、下拉选择、文本改变......
信号处理方式 信号处理函数(signal/sigaction注册) 槽函数(connect关联)
  • Qt 中使用 connect这样的函数,把一个信号和一个槽关联起来。信号一旦触发,就会执行对应的槽函数。
  • 细节:Linux 信号是异步的,由内核通知进程;而 Qt 的信号,本质上就是一次函数调用。在同一个线程里,emit一个信号后,所有关联的槽函数会被依次执行完,emit才返回。

1.2 槽函数就是回调函数

  槽函数,也是一种回调函数。回调函数的概念在很多地方都出现过:

  • 实现转移表(函数指针表)
  • C++ 中的仿函数、lambda表达式
  • Linux 中的信号处理函数、线程入口函数
  • epoll的回调机制

  它们共同的特点是:处理方式需要提前准备好,等到事件触发时再被调用。信号槽也是一样:先用 connect把"谁来处理"准备好,再等用户触发信号。

二、connect 函数

2.1 connect 是谁提供的

  connect是 QObject 提供的函数(静态成员函数)。而 QWidget继承了 QObject,各种控件又继承自 QWidget:

  QObject是这些类的"祖宗类",所以在任意一个 Qt 类中都可以直接使用 connect。

2.2 connect 的声明

cpp 复制代码
QMetaObject::Connection connect(const QObject *sender,
                                const char *signal,
                                const QObject *receiver,
                                const char *method,
                                Qt::ConnectionType type = Qt::AutoConnection);
  • sender:信号源,哪个对象发出信号。
  • signal:信号类型,发出的是什么信号。
  • receiver:哪个对象来处理这个信号。
  • method:这个对象具体怎么处理(槽函数)。
  • type:连接方式,涉及多线程相关的内容,暂时不考虑,也很少使用,默认值就行。

声明里的参数是 const char*,为什么我们传的却是函数指针?

上面给出的是 Qt 5 之前的声明(用字符串指定信号和槽)。从 Qt 5 开始,connect增加了基于模板(泛型)的版本,可以直接传函数指针,写起来更简洁,而且在编译期就能检查参数是否匹配。

2.3 信号和槽是什么样的函数

  以按钮为例:

  • clicked:是信号,表示按钮"已经被点击完了",发出的通知。
  • click:是槽函数,作用相当于"程序模拟点击一下按钮"。

  在 Qt 的帮助文档里,信号和槽是分开列出的,可以据此区分。

  connect对信号和槽是匹配的有要求。比如button的类型是QPushButton*,那么第二个参数的信号,必须是 QPushButton内置的信号(或者它父类 的信号),不能是其他不相关的类的信号,比如 QLineEdit的信号。

2.4 例子:点击按钮关闭窗口

  在 Widget的构造函数中编写:

cpp 复制代码
QPushButton* button = new QPushButton(this);
button->setText("关闭");
button->move(200, 200);
connect(button, &QPushButton::clicked, this, &Widget::close);
  • Widget::close是 QWidget内置的槽函数,作用是关闭当前窗口/控件。
  • 对应四个要素:button发出 clicked信号,由 this(当前窗口)调用 close来处理。

三、自定义槽函数

  Qt 内置的槽函数毕竟有限,实际开发中,自定义槽函数是非常关键的,大部分的业务逻辑都要写在自己的槽函数里。

  所谓的槽,就是一个普通的成员函数,在头文件中声明,在源文件中定义。

  • 细节:在 Qt 5 之前,槽函数必须声明在 public slots:之类的区域下;Qt 使用了一种基于代码生成代码 的技术(moc会扫描头文件,生成额外的代码)。现在直接当作普通成员函数写就行。

3.1 方式一:手动 connect

  例子:点击按钮,修改窗口的标题。

widget.h:

cpp 复制代码
class Widget : public QWidget
{
    Q_OBJECT
    // ...
private:
    void handleClick();     // 槽函数,就是一个普通的成员函数
};

widget.cpp:

cpp 复制代码
// 构造函数中
QPushButton* button = new QPushButton("修改标题", this);
connect(button, &QPushButton::clicked, this, &Widget::handleClick);

void Widget::handleClick()
{
    this->setWindowTitle("按钮已经按下");
}

3.2 方式二:图形化界面"转到槽"

  如果控件是在图形化界面里创建的,还有一种更快捷的方式:

  1. 在 .ui设计界面中,右键按钮 → 转到槽。
  2. 弹出的窗口中,列出了这个控件的所有信号 ,选中 clicked(),点击确定。
  3. 编辑器会自动跳到源文件,函数的声明和定义已经自动写好了,直接在这个基础上编写逻辑就行。
cpp 复制代码
void Widget::on_pushButton_clicked()
{
    this->close();
}

这里代码里并没有写 connect,为什么点击按钮就有反应?

Qt 中,除了用 connect来连接信号槽,还可以通过函数名字 的方式来自动连接!只要函数名符合下面的规则,Qt 就能自动把信号和槽建立联系:

bash 复制代码
on_<控件的objectName>_<信号名>
  • on:槽函数的标识。
  • pushButton:控件的 objectName(用来标明是哪个控件)。
  • clicked:表示是这个控件的哪个信号。

  可以改一下函数名来验证:把函数名改成不符合规则的名字,再点击按钮,就没有反应了,并且在应用程序输出窗口里会有提示:找不到匹配的信号。

自动连接是什么时候发生的?

是在 QMetaObject::connectSlotsByName 被调用的时候。这个函数在自动生成的 ui_widget.h里(setupUi的末尾)被调用,调用时会扫描所有符合规则的槽函数名,自动把信号槽连接起来。

总结:

  • 如果是通过图形化界面创建的控件,推荐使用这种快速的方式来连接信号槽。
  • 如果是通过代码 的方式来创建控件,还是得手动 connect(因为你的代码中没有调用 connectSlotsByName)。
  • 注意:如果修改了控件的 objectName,对应槽函数的名字也要同步修改,否则自动连接会失效。

四、自定义信号

  和自定义槽函数相比,自定义信号相对少见。因为 Qt 的内置控件已经提供了大量的信号,覆盖了用户的大部分操作(点击、勾选、输入、下拉选择等)。但在编写自定义控件、或者对象之间需要解耦通信的时候,也会用到。

  Qt信号的本质 :函数,但是一个很特殊的函数:

  • 这个函数的定义是 Qt 在编译过程中自动生成的,程序员只负责声明,无法干预,也不用写实现。
  • 作为信号函数,返回值必须是 void,参数可以有,并且支持重载。
  • 声明时要使用 signals 关键字。这也是 Qt 自己扩展出来的关键字,Qt 在编译时扫描到它,就会把下面的函数声明当作信号,并给这些信号函数自动生成函数定义。

4.1 声明信号和槽

  在 widget.h中声明:

cpp 复制代码
signals:
    void mySignal();            // 自定义信号:只声明,不实现

private:
    void handleMySignal();      // 处理这个信号的槽函数

  在 widget.cpp中实现槽函数:

cpp 复制代码
void Widget::handleMySignal()
{
    this->setWindowTitle("处理自定义信号");
}

4.2 连接并触发信号

  使用 connect把信号和槽连接起来(可以在构造函数中):

cpp 复制代码
connect(this, &Widget::mySignal, this, &Widget::handleMySignal);

  怎么触发信号? 使用 emit 关键字来发送自定义信号(也可以发送系统内置的信号):

cpp 复制代码
emit mySignal();
  • 细节:在 Qt 5 以后,emit其实可以省略(它本身是个空的宏),但为了提高代码可读性,还是推荐写上,一眼就能看出这里在发送信号。

  发送信号的操作,可以放在任意合适的代码中,不一定非得在构造函数里。比如在上一节的按钮槽函数里发送:

cpp 复制代码
void Widget::on_pushButton_clicked()
{
    // 点击按钮的时候,发送自定义信号
    emit mySignal();
}

整个执行流程是:点击按钮 → on_pushButton_clicked → emit mySignal → handleMySignal。

五、带参数的信号槽

  信号和槽是可以带参数的。当信号带参数时,发送信号时的实参,会传到槽函数里。

  其实内置信号里就有带参数的例子:pushButton有两个 clicked信号,一个带 bool 参数,一个不带参数:

  • clicked(bool checked):参数表示按钮当前是否被选中,对可勾选的按钮(比如复选框)才有意义。

  下面用自定义的信号和槽,来验证带参数的情况。

5.1 验证

  先将自定义信号声明为带两个参数:

cpp 复制代码
signals:
    void mySignal(const QString& str1, const QString& str2);

槽函数声明为带一个参数:

cpp 复制代码
void handleMySignal(const QString& str);

在图形化界面中,设置两个按钮:

函数实现:

cpp 复制代码
// 构造函数中连接
connect(this, &Widget::mySignal, this, &Widget::handleMySignal);

void Widget::handleMySignal(const QString& str)
{
    this->setWindowTitle(str);
}

void Widget::on_pushButton_1_clicked()
{
    emit mySignal("标题1", "");
}

void Widget::on_pushButton_2_clicked()
{
    emit mySignal("标题2", "");
}

  点击不同的按钮,窗口标题就会变成不同的内容:两个按钮共用同一个槽函数 ,只是传进去的参数不同。传参可以提高代码的复用率。

5.2 参数的规则

  • 槽函数的参数类型必须和信号对应位置的参数匹配。(大家可以自行验证参数类型不匹配的情况)
  • 参数个数可以不一致,但信号的参数个数不能少于槽函数的参数个数。槽函数会按参数顺序,拿到信号的前 N 个参数。
  • 反过来(槽的参数比信号多)是不行的,新语法下会直接编译不通过。

直观来看,应该要求信号和槽的参数个数严格一致才对,为什么允许信号的参数比槽多?

  因为一个槽函数,有可能会绑定多个信号。如果严格要求参数个数一致,信号绑定到槽的要求就变得很高了。允许信号的参数比槽多,就让信号和槽之间的绑定更灵活,更多的信号可以绑定到同一个槽函数上。
  反过来,信号给槽的参数少了,槽函数就不够分 了,没法调用。

六、信号槽的意义

  信号槽终究要解决的问题,就是响应用户的操作。这个机制的设想是很美好的,有两个明显的好处:

  1. 解耦合:把"触发用户操作的控件"和"处理对应操作的逻辑"解耦合。控件只管发信号,不用关心谁来处理。
  2. 多对多:一个信号,可以 connect到多个槽函数 上;一个槽函数,也可以被多个信号 connect。

  一个信号连接多个槽,可以这样验证:给同一个信号connect两个槽函数,让它们修改的内容不一样,再用打印日志的方式,看看是不是两个槽函数都被调用了。(多个槽函数会按连接的顺序依次执行)

6.1 disconnect:断开连接

  使用 disconnect可以断开信号和槽的连接,用法和 connect一样:

cpp 复制代码
disconnect(button, &QPushButton::clicked, this, &Widget::handleClick1);
  • 实际开发中用得很少。比如想把信号从"槽 1"切换到"槽 2",就会用到:先 disconnect掉槽 1,再 connect槽 2。
  • 如果没有 disconnect,一个信号就会触发两个槽函数,变成"一对多"。

七、使用 lambda 作为槽函数

  槽函数除了写成成员函数,还可以直接使用 lambda 表达式。在回调函数的场景里,通常都会用到 lambda,它不需要单独声明、定义一个函数,代码更紧凑:

cpp 复制代码
QPushButton* button = new QPushButton("移动", this);
button->move(200, 200);

connect(button, &QPushButton::clicked, this, [button, this]() {
    qDebug() << "lambda 被执行了!";
    button->move(300, 300);
    this->move(100, 100);
});
  • 点击按钮后:按钮移动到 (300, 300),窗口移动到屏幕的 (100, 100)。

  • 注意:捕获列表要用按值捕获([button, this]或 [=]),不要用 [&]。button是构造函数里的局部变量,构造函数结束后就销毁了,而 lambda 是在点击时才执行,按引用捕获会访问到已经失效的变量。

八、使用信号槽的注意事项

  Qt 中,要让某个类能够使用信号槽(也就是在类中定义信号和槽函数),必须在类的最开始处写上 Q_OBJECT 宏。 这是 Qt 的硬性规定,这个宏会展开成很多额外的代码,并配合 moc生成信号的定义。

  • 自定义类时要使用信号和槽,必须写 Q_OBJECT,否则自定义的信号没有定义,通常会在链接阶段 报错(undefined reference)。
  • 给已有的类新加 Q_OBJECT后,需要重新执行 qmake(构建菜单里),让 moc重新生成代码,否则也会报错。

九、总结

内容 要点
信号槽三要素 信号源、信号类型、处理方式(槽),槽函数本质是回调函数
connect connect(sender, signal, receiver, method),QObject提供,Qt 5 起可直接传函数指针
自定义槽 就是普通成员函数;图形化界面可"转到槽",按 on_控件名_信号名命名自动连接(connectSlotsByName)
自定义信号 signals关键字声明、不用实现,返回值 void;emit发送信号
带参数 类型匹配,信号的参数个数 ≥ 槽的参数个数
意义 解耦合、多对多;disconnect断开连接
lambda 不需要单独写槽函数,注意按值捕获
注意 使用信号槽的类必须有 Q_OBJECT

非常感谢您能耐心读完这篇文章。倘若您从中有所收获,还望多多支持呀!🎉

相关推荐
联犀1 小时前
ai时代复杂项目的golang项目如何更好的与ai共舞:monorepo+gozero
开发语言·人工智能·golang
牢姐与蒯2 小时前
cpp算法之哈希
c++·算法·哈希算法
lcj25113 小时前
[C++] C++11
开发语言·c++·笔记
Evand J5 小时前
【MATLAB例程】基于IMM-CKF的AOA+测距融合的二维移动目标跟踪定位
开发语言·matlab·目标跟踪
JianZhen✓6 小时前
IM 聊天列表为什么总“消息乱跳“:有序插入、时间轴派生、本地截断、已读回执
开发语言·前端·php
FungLeo6 小时前
FengCMS · PHP+MySQL 升级实录· 代码审计怎么闭环:REVIEW到 CLOSURE 四件套,12 个域90 篇修复文档跟到底
开发语言·mysql·php·代码审计·fengcms
七夜zippoe6 小时前
多轮对话管理:Session/记忆在 Java 后端怎么存(存储设计实战)
java·开发语言·ai·session·记忆
小小bugbug6 小时前
带工作窃取的线程池
c++·线程池
屿华AI6 小时前
AUTOSAR 实战-诊断工具 | 基于 Python 与 USB-CANFD 的 UDS 诊断测试工具设计与实现
开发语言·python·测试工具