【Qt开发】信号与槽(三)-> 自定义信号和槽

发布于:2025-07-31 ⋅ 阅读:(28) ⋅ 点赞:(0)

目录

1 -> 基本语法

2 -> 带参数的信号和槽

3 -> 小结


1 -> 基本语法

在 Qt 中,允许自定义信号的发送方以及接收方,即可以自定义信号函数和槽函数。但是对于自定义的信号函数和槽函数有一定的书写规范。

一、自定义信号函数书写规范

  1. 自定义信号函数必须写到 “signals” 下
  2. 返回值为 void,只需要声明,不需要实现
  3. 可以有参数,也可以发生重载

二、自定义槽函数书写规范

  1. 早期的 Qt 版本要求槽函数必须写到 “public slots”下,但是现在高级版本的 Qt 允许写到类的 “public” 作用域中或者全局下
  2. 返回值为 void,需要声明,也需要实现
  3. 可以有参数,也可以发生重载

三、发送信号

使用 “emit” 关键字发送信号。“emit” 是一个空的宏。“emit” 其实是可选的,没有什么含义,只是为了提醒开发人员。

示例1:

1. 在 widget.h 中声明自定义的信号和槽

2. 在 widget.cpp 中实现槽函数,并且关联信号和槽

注意:下图中的 1 和 2 的顺序不可以颠倒

因为,首先关联信号和槽,一旦检测到信号发射之后就会立马执行关联的槽函数。反之,如若先发射信号,此时还没有关联槽函数,当信号发射之后槽函数不会响应。

示例2:当老师说 “上课了”,学生们就 “回到座位,开始学习”

1. 在源文件中新建两个类,一个是老师类,一个是学生类。首先选中项目名称,鼠标右键 => “add new……”

点击 “add new……” 之后,出现如下界面

选择 “choose” 出现如下界面。

注意:在 Qt 中新建类时,要选择新建类的父类。

很显然,在当前项目中还没有什么类适合做新类的父类,同时新的类也不是一个 “窗口” 或者 “控件”。这种情况一般选择 QObject 作为基类。

这样做的好处是:这个新类的对象可以搭配 Qt 的对象树机制。便于对象的正确释放。

选择 “下一步”,出现如下界面

对于 “学生类” 以上述同样的方式进行添加,添加完成之后,项目目录新增文件如下

在 teacher.h 中声明信号函数

在 studio.h 中声明槽函数

在 widget.h 中实例化 “老师类对象” 和 “学生类对象”

在 studio.cpp 中实现槽函数

在 widget.cpp 中连接自定义信号和槽

运行结果如下图

示例3:老师点击 “按钮” 触发学生上课

运行结果如下图

2 -> 带参数的信号和槽

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

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

此时信号触发,调用到槽函数时,信号函数中的实参就能够被传递到槽函数的形参中。

通过这样的机制,就可以让信号给槽传递数据了。

示例1:重载信号槽

1. 在 “widget.h” 头文件中声明重载的信号函数以及重载的槽函数

2. 在 “Widget.cpp” 文件实现重载槽函数以及连接信号和槽

注意:在定义函数指针时要指明函数指针的作用域

3. 执行结果如下图

示例2:信号槽参数列表匹配规则

1. 在 “widget.h” 头文件中声明信号和槽函数

2. 在 “widget.cpp” 文件中实现槽函数以及连接信号和槽

其实信号的参数个数可以多于槽函数的参数个数,但是槽的参数个数不能多于信号的参数个数。

但是在实际开发中最好保持参数个数也能匹配一致。

示例3:

1. 在 “widget.h” 头文件中声明信号和槽函数

2. 在 “widget.cpp”文件中实现槽函数以及连接信号和槽

3 -> 小结

一、基本语法规范

1. 自定义信号

  • 必须声明在类的 signals: 区域

  • 返回类型必须为 void,只需声明无需实现(Qt自动生成)

  • 支持参数传递和重载

  • 通过 emit 关键字触发(实际是空宏,但建议显式使用)                                               

signals:
    void mySignal(int value);  // 声明

2. 自定义槽

  • 可声明在 public slots: 或普通 public: 区域

  • 需完整实现函数逻辑,返回类型为 void

  • 支持参数传递和重载

public slots:
    void mySlot(int data);     // 声明+实现

二、参数传递规则

  1. 核心机制

    • 信号参数自动传递给槽函数形参

    • 参数数量兼容性

      • 槽函数参数数量  信号参数数量(多余参数被忽略)

      • 禁止槽参数数量 > 信号参数数量(编译错误)

    • 参数类型必须严格匹配(如 int 不能隐式转 QString

  2. 重载处理

    • 需用 static_cast 明确指定函数指针类型:

// 重载信号连接
connect(sender, static_cast<void(SenderClass::*)(int)>(&SenderClass::overloadedSignal),
        receiver, &ReceiverClass::slotForInt);

三、实战注意事项

1. 连接顺序

  • 必须先 connect 再 emit 信号,否则槽函数不会触发

connect(teacher, &Teacher::classBegin, student, &Student::enterClass); // 1. 连接
emit teacher->classBegin(); // 2. 触发信号

2. 对象生命周期

  • 通过 对象树机制 自动管理内存(推荐继承 QObject

  • 典型错误:槽函数访问已销毁对象 → 崩溃

  • 解决方案:

    • 使用 QPointer 弱指针

    • 显式调用 disconnect()

3. 参数设计建议

  • 优先使用 一致参数列表(避免隐式截断)

  • 跨线程传递时,参数类型需注册元类型(qRegisterMetaType


感谢各位大佬支持!!!

互三啦!!!


网站公告

今日签到

点亮在社区的每一天
去签到