一、基本概念
上一篇我们用 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 方式二:图形化界面"转到槽"
如果控件是在图形化界面里创建的,还有一种更快捷的方式:
- 在
.ui设计界面中,右键按钮 → 转到槽。 - 弹出的窗口中,列出了这个控件的所有信号 ,选中
clicked(),点击确定。 - 编辑器会自动跳到源文件,函数的声明和定义已经自动写好了,直接在这个基础上编写逻辑就行。

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 个参数。
- 反过来(槽的参数比信号多)是不行的,新语法下会直接编译不通过。
直观来看,应该要求信号和槽的参数个数严格一致才对,为什么允许信号的参数比槽多?
因为一个槽函数,有可能会绑定多个信号。如果严格要求参数个数一致,信号绑定到槽的要求就变得很高了。允许信号的参数比槽多,就让信号和槽之间的绑定更灵活,更多的信号可以绑定到同一个槽函数上。
反过来,信号给槽的参数少了,槽函数就不够分 了,没法调用。
六、信号槽的意义
信号槽终究要解决的问题,就是响应用户的操作。这个机制的设想是很美好的,有两个明显的好处:
- 解耦合:把"触发用户操作的控件"和"处理对应操作的逻辑"解耦合。控件只管发信号,不用关心谁来处理。
- 多对多:一个信号,可以
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 |
非常感谢您能耐心读完这篇文章。倘若您从中有所收获,还望多多支持呀!🎉
