Qt 的原理及使用（5）——信号与槽

炬火初现

于 2025-05-13 10:00:00 发布

阅读量1.2k

点赞数 43

文章标签： qt 开发语言

本文链接：https://blog.csdn.net/qq_35639854/article/details/147847285

版权

1. 信号和槽概述

在 Qt 中，⽤⼾和控件的每次交互过程称为⼀个事件。⽐如 "⽤⼾点击按钮" 是⼀个事件，"⽤⼾关

闭窗⼝" 也是⼀个事件。每个事件都会发出⼀个信号，例如⽤⼾点击按钮会发出 "按钮被点击" 的信

号，⽤⼾关闭窗⼝会发出 "窗⼝被关闭" 的信号。

Qt 中的所有控件都具有接收信号的能⼒，⼀个控件还可以接收多个不同的信号。对于接收到的每

个信号，控件都会做出相应的响应动作。例如，按钮所在的窗⼝接收到 "按钮被点击" 的信号后，会做出 "关闭⾃⼰" 的响应动作；再⽐如输⼊框⾃⼰接收到 "输⼊框被点击" 的信号后，会做出 "显⽰闪烁的光标，等待⽤⼾输⼊数据" 的响应动作。在 Qt 中，对信号做出的响应动作就称之为槽。

信号和槽是 Qt 特有的消息传输机制，它能将相互独⽴的控件关联起来。⽐如，"按钮" 和 "窗⼝"

本⾝是两个独⽴的控件，点击 "按钮" 并不会对 "窗⼝" 造成任何影响。通过信号和槽机制，可以将 "按钮" 和 "窗⼝" 关联起来，实现 "点击按钮会使窗⼝关闭" 的效果。

1.1信号的本质

信号是由于⽤⼾对窗⼝或控件进⾏了某些操作，导致窗⼝或控件产⽣了某个特定事件，这时 Qt 对

应的窗⼝类会发出某个信号，以此对⽤⼾的操作做出反应。因此，信号的本质就是事件。如：

• 按钮单击、双击 • 窗⼝刷新

• ⿏标移动、⿏标按下、⿏标释放

• 键盘输⼊

那么在 Qt 中信号是通过什么形式呈现给使⽤者的呢？

• 我们对哪个窗⼝进⾏操作, 哪个窗⼝就可以捕捉到这些被触发的事件。

• 对于使⽤者来说触发了⼀个事件我们就可以得到 Qt 框架给我们发出的某个特定信号。

• 信号的呈现形式就是函数，也就是说某个事件产⽣了， Qt 框架就会调⽤某个对应的信号函数，通知使⽤者。在 Qt 中信号的发出者是某个实例化的类对象。

1.2槽的本质

槽（Slot）就是对信号响应的函数。槽就是⼀个函数，与⼀般的 C++ 函数是⼀样的，可以定义在

类的任何位置（ public、protected 或 private ），可以具有任何参数，可以被重载，也可以被直接调⽤（但是不能有默认参数）。槽函数与⼀般的函数不同的是：槽函数可以与⼀个信号关联，当信号被发射时，关联的槽函数被⾃动执⾏。

说明

（1）信号和槽机制底层是通过函数间的相互调⽤实现的。每个信号都可以⽤函数来表⽰，称为信号函数；每个槽也可以⽤函数表⽰，称为槽函数。例如: "按钮被按下" 这个信号可以⽤ clicked() 函数表⽰，"窗⼝关闭" 这个槽可以⽤ close() 函数表⽰，假如使⽤信号和槽机制-

实现："点击按钮会关闭窗⼝" 的功能，其实就是 clicked() 函数调⽤ close() 函数的效果。

（2）信号函数和槽函数通常位于某个类中，和普通的成员函数相⽐，它们的特别之处在于：

• 信号函数⽤ signals 关键字修饰，槽函数⽤ public slots、protected slots 或者 private slots 修

饰。signals 和 slots 是 Qt 在 C++ 的基础上扩展的关键字，专⻔⽤来指明信号函数和槽函数；

• 信号函数只需要声明，不需要定义（实现），⽽槽函数需要定义（实现）。

信号函数的定义是 Qt ⾃动在编译程序之前⽣成的. 编写 Qt 应⽤程序的程序猿⽆需关注.
这种⾃动⽣成代码的机制称为 元编程 (Meta Programming) . 这种操作在很多场景中都能⻅
到.

2. 信号和槽的使⽤

2.1 连接信号和槽

在 Qt 中，QObject 类提供了⼀个静态成员函数 connect() ，该函数专⻔⽤来关联指定的信号函数和槽函数。

关于 QObject
QObject 是 Qt 内置的⽗类. Qt 中提供的很多类都是直接或者间接继承⾃ QObject.

connect() 函数原型：

connect (const QObject *sender, 
 const char * signal ,
 const QObject * receiver , 
 const char * method , 
 Qt::ConnectionType type = Qt::AutoConnection )

参数说明：

• sender：信号的发送者；

• signal：发送的信号（信号函数）；

• receiver：信号的接收者；

• method：接收信号的槽函数；

• type：⽤于指定关联⽅式，默认的关联⽅式为 Qt::AutoConnection，通常不需要⼿动设定。

代码⽰例: 在窗⼝中设置⼀个按钮，当点击 "按钮" 时关闭 "窗⼝" .

2.2 查看内置信号和槽

系统⾃带的信号和槽通常是通过 "Qt 帮助⽂档" 来查询。

如上述⽰例，要查询 "按钮" 的信号，在帮助⽂档中输⼊：QPushButton，

• ⾸先可以在 "Contents" 中寻找关键字 signals，

• 如果没有找到, 继续去⽗类中查找. 因此我们去他的⽗类 QAbstractButton 中继续查找关键字

signals，

这⾥的 clicked() 就是要找的信号。槽函数的寻找⽅式和信号⼀样，只不过它的关键字是 slot 。

2.3 通过 Qt Creator ⽣成信号槽代码

Qt Creator 可以快速帮助我们⽣成信号槽相关的代码.

代码⽰例: 在窗⼝中设置⼀个按钮，当点击 "按钮" 时关闭 "窗⼝" .

新建项⽬，如下图为新建完成之后所包含的所有⽂件；

注意：创建时要⽣成 UI 设计⽂件

双击 widget.ui ⽂件，进⼊ UI 设计界⾯；

1.在 UI 设计窗⼝中拖⼊⼀个 "按钮" ，并且修改 "按钮" 的名称及字体⼤⼩等；

2、可视化⽣成槽函数；

当单击 "转到槽..." 之后，出现如下界⾯：对于按钮来说，当点击时发送的信号是：clicked()，所以此处选择：clicked()

3、⾃动⽣成槽函数原型框架；

（1）在 "widget.h" 头⽂件中⾃动添加槽函数的声明；

说明：

⾃动⽣成槽函数的名称有⼀定的规则。槽函数的命名规则为：on_XXX_SSS，其中：

1、以 " on " 开头，中间使⽤下划线连接起来；

2、" XXX " 表⽰的是对象名(控件的 objectName 属性)。

3、" SSS " 表⽰的是对应的信号。

如：" on_pushButton_clicked() " ，pushButton 代表的是对象名，clicked 是对应的信号。

按照这种命名⻛格定义的槽函数, 就会被 Qt ⾃动的和对应的信号进⾏连接.
但是咱们⽇常写代码的时候, 除⾮是 IDE ⾃动⽣成, 否则最好还是不要依赖命名规则, ⽽是显式
使⽤ connect 更好.
⼀⽅⾯显式 connect 可以更清晰直观的描述信号和槽的连接关系.
另⼀⽅⾯也防⽌信号或者槽的名字拼写错误导致连接失效.
(当然, 是配置⼤于约定, 还是约定⼤于配置, 哪种更好, 这样的话题业界尚存在争议. 此处我个
⼈还是更建议优先考虑显式 connect)

4.在 "widget.cpp" 中⾃动⽣成槽函数定义.

5.在槽函数函数定义中添加要实现的功能. 实现关闭窗⼝的效果.

3. ⾃定义信号和槽

3.1 基本语法

在 Qt 中，允许⾃定义信号的发送⽅以及接收⽅，即可以⾃定义信号函数和槽函数。但是对于⾃定义的

信号函数和槽函数有⼀定的书写规范。

1、⾃定义信号函数书写规范

（1）⾃定义信号函数必须写到 "signals" 下；

（2）返回值为 void，只需要声明，不需要实现；

（3）可以有参数，也可以发⽣重载；

2、⾃定义槽函数书写规范

（1）早期的 Qt 版本要求槽函数必须写到 "public slots" 下，但是现在⾼级版本的 Qt 允许写到类的

"public" 作⽤域中或者全局下；

（2）返回值为 void，需要声明，也需要实现；

（3）可以有参数，可以发⽣重载；

3、发送信号

使⽤ "emit" 关键字发送信号。"emit" 是⼀个空的宏。"emit" 其实是可选的，没有什么含义，只

是为了提醒开发⼈员。

3.2使用实例

1、在 widget.h 中声明⾃定义的信号和槽，如图所⽰；

2、在 MainWindow.cpp 中实现槽函数，并且关联信号和槽

注意：图中的 ① 和 ② 的顺序不能颠倒。

原因是, ⾸先关联信号和槽，⼀旦检测到信号发射之后就会⽴⻢执⾏关联的槽函数。反之，若先发射信号，此时还没有关联槽函数，当信号发射之后槽函数不会响应.

3.3 带参数的信号和槽

Qt 的信号和槽也⽀持带有参数, 同时也可以⽀持重载.

此处我们要求, 信号函数的参数列表要和对应连接的槽函数参数列表⼀致.

此时信号触发, 调⽤到槽函数的时候, 信号函数中的实参就能够被传递到槽函数的形参当中.

使用实例

（1）在 "widget.h" 头⽂件中声明重载的信号函数以及重载的槽函数；如下图所⽰：

（2）在 "Widget.cpp" ⽂件实现重载槽函数以及连接信号和槽。

注意：在定义函数指针时要指明函数指针的作⽤域。

（3）执⾏结果如下图所⽰：

其实信号的参数个数可以多于槽函数的参数个数，但是槽的参数个数不能多于信号参数个数.
但是实际开发中最好还是保持参数个数也能匹配⼀致.

4. 信号与槽的连接⽅式

4.1 ⼀对⼀

主要有两种形式，分别是：⼀个信号连接⼀个槽和⼀个信号连接⼀个信号。

（1）⼀个信号连接⼀个槽

4.2 ⼀对多

⼀个信号连接多个槽

（2）在 "widget.cpp" ⽂件中实现槽函数以及连接信号和槽；

4.3 多对⼀

多个信号连接⼀个槽函数

5. 信号和槽的其他说明

5.1 信号与槽的断开

使⽤ disconnect 即可完成断开.

disconnect 的⽤法和 connect 基本⼀致.

5.2 使⽤ Lambda 表达式定义槽函数

Qt5 在 Qt4 的基础上提⾼了信号与槽的灵活性，允许使⽤任意函数作为槽函数。

但如果想⽅便的编写槽函数，⽐如在编写函数时连函数名都不想定义，则可以通过 Lambda表达式来达到这个⽬的。

Lambda表达式是 C++11 增加的特性。C++11 中的 Lambda表达式⽤于定义并创建匿名的函数对

象，以简化编程⼯作。

Lambda表达式的语法格式如下：

[ capture ] ( params ) opt -> ret { 
Function body; 
};

| capture | 捕获列表 |
| ---- | ---- |
| params | 参数表 |
| opt | 函数选项 |
| ret | 返回值类型 |
| Function body | 函数体 |

说明：

• 由于使⽤引⽤⽅式捕获对象会有局部变量释放了⽽Lambda函数还没有被调⽤的情况。如果执⾏

Lambda函数，那么引⽤传递⽅式捕获进来的局部变量的值不可预知。所以绝⼤多数场合使⽤的形

式为： [=] () { }

• 早期版本的 Qt，若要使⽤Lambda表达式，要在 ".pro" ⽂件中添加： CONFIG += C++11

因为 Lambda表达式是 C++11 标准提出的。Qt5 以上的版本⽆需⼿动添加，在新建项⽬时会⾃动

添加。

5.3 信号与槽的优缺点

优点: 松散耦合

信号发送者不需要知道发出的信号被哪个对象的槽函数接收，槽函数也不需要知道哪些信号关联了⾃⼰，Qt的信号槽机制保证了信号与槽函数的调⽤。⽀持信号槽机制的类或者⽗类必须继承于 QObject 类。

缺点: 效率较低

与回调函数相⽐，信号和槽稍微慢⼀些，因为它们提供了更⾼的灵活性，尽管在实际应⽤程序中差别不⼤。通过信号调⽤的槽函数⽐直接调⽤的速度慢约10倍（这是定位信号的接收对象所需的开销；遍历所有关联；编组/解组传递的参数；多线程时，信号可能需要排队），这种调⽤速度对性能要求不是⾮常⾼的场景是可以忽略的，是可以满⾜绝⼤部分场景。

⼀个客⼾端程序中, 最慢的环节往往是 "⼈".

假设本⾝基于回调的⽅式是 10us, 使⽤信号槽的⽅式是 100us. 对于使⽤程序的⼈来说, 是感

知不到的.