QT —— 信号和槽（带参数的信号和槽函数）

最新推荐文章于 2025-05-04 07:08:18 发布
最新推荐文章于 2025-05-04 07:08:18 发布
阅读量1k 收藏 10
点赞数 24
分类专栏： QT 文章标签： qt 开发语言
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/qq_67693066/article/details/147650153
版权

QT —— 信号和槽（带参数的信号和槽函数）

我们之前已经了解了QT当中的信号，并且已经了解了自定义信号和自定义槽函数应该怎样书写，如果还不了解的小伙伴可以点击这里：

https://blog.csdn.net/qq_67693066/article/details/147278172
https://blog.csdn.net/qq_67693066/article/details/147275998

我们今天来看一下带参的信号和槽函数应该是怎么样的：

带参的信号和槽函数

其实还是比较简单，在头文件声明，在cpp文件中实现就行了：

#ifndef WIDGET_H
#define WIDGET_H

#include <QWidget>
#include <QString>
#include <QDebug>

QT_BEGIN_NAMESPACE
namespace Ui { class Widget; }
QT_END_NAMESPACE

class Widget : public QWidget
{
    Q_OBJECT

public:
    Widget(QWidget *parent = nullptr);
    ~Widget();
//槽函数
public slots:
    void myaction_1(const QString&);

//声明信号
signals:
    void mysignal_1(const QString&); //设置参数为QString

private:
    Ui::Widget *ui;
};
#endif // WIDGET_H


#include "widget.h"
#include "ui_widget.h"
#include <QPushButton>

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{

    ui->setupUi(this);

    // 连接 Widget 的自定义信号到槽函数
    connect(this, &Widget::mysignal_1, this, &Widget::myaction_1);

    //发射信号
    emit Widget::mysignal_1("this this my text"); //传递了参数
}

//实现槽函数
void Widget::myaction_1(const QString& text)
{
    qDebug() << text;
}

Widget::~Widget()
{
    delete ui;
}

在这里插入图片描述

信号参数个数和槽函数参数个数

在 Qt 的信号和槽机制中，槽函数的参数个数可以少于或等于信号的参数个数，但不能多于信号的参数个数。这是 Qt 信号和槽连接的重要规则之一。

1. 参数匹配规则

情况信号参数槽函数参数是否合法说明
1void signal()void slot()✅ 合法无参数，完全匹配
2void signal(int)void slot(int)✅ 合法参数类型和数量完全匹配
3void signal(int, QString)void slot(int)✅ 合法槽可以忽略后面的参数
4void signal(int)void slot(int, QString)❌ 不合法槽的参数不能多于信号
5void signal(int)void slot(QString)❌ 不合法参数类型必须兼容
6void signal(int)void slot()✅ 合法槽可以完全不接收参数

2. 实际代码示例

✅ 合法连接（槽参数 ≤ 信号参数）
// 信号：带两个参数
signals:
    void dataReady(int value, const QString &message);

// 槽1：完全匹配（两个参数）
public slots:
    void handleData(int value, const QString &msg) {
        qDebug() << "Value:" << value << "Message:" << msg;
    }

// 槽2：只接收第一个参数（忽略第二个）
    void handleValueOnly(int value) {
        qDebug() << "Value:" << value;
    }

// 槽3：无参数
    void handleNoArgs() {
        qDebug() << "Data received!";
    }

// 连接方式（Qt5 风格）
connect(this, &MyClass::dataReady, this, &MyClass::handleData);      // 完全匹配
connect(this, &MyClass::dataReady, this, &MyClass::handleValueOnly); // 忽略第二个参数
connect(this, &MyClass::dataReady, this, &MyClass::handleNoArgs);    // 无参数
❌ 非法连接（槽参数 > 信号参数）
// 槽4：尝试接收三个参数（但信号只有两个）
public slots:
    void handleInvalid(int a, const QString &b, bool c) {  // 编译报错！
        qDebug() << a << b << c;
    }

// 错误连接
connect(this, &MyClass::dataReady, this, &MyClass::handleInvalid);  // 编译失败

3. 特殊处理：使用 Lambda 适配参数

如果信号和槽的参数不匹配，可以通过 Lambda 表达式 转换参数：

connect(this, &MyClass::dataReady, this, [this](int v, const QString &m) {
    mySlot(v, m, true);  // 手动添加额外参数
});

// 槽函数（三个参数）
void mySlot(int v, const QString &m, bool extra) {
    qDebug() << v << m << extra;
}

4. 注意事项

  1. 参数类型必须兼容

    • 如果信号是 int，槽可以是 int 或 double（隐式转换），但不能是 QString。
    • 例如：
      signals: void valueChanged(int);
slots: void logValue(double);  // ✅ OK（int → double）
slots: void logValue(QString); // ❌ 错误（类型不匹配）

  2. 默认参数的影响

    • 如果槽有默认参数，实际调用时未传递的参数会使用默认值：
      slots: void showMessage(const QString &msg, bool bold = false);
// 可以连接单参数信号：
signals: void messageSent(const QString &);

  3. 旧式 Qt4 语法的限制

    • 使用 SIGNAL 和 SLOT 宏时，参数类型必须严格匹配（不支持隐式转换）：
      connect(btn, SIGNAL(clicked(bool)), this, SLOT(showMessage(QString)));  // ❌ 错误

总结

  • 槽的参数个数 ≤ 信号的参数个数，且类型必须兼容。
  • 多余参数可忽略，但缺少参数或类型不匹配会导致编译/运行时错误。
  • 使用 Lambda 表达式可以灵活适配参数不匹配的情况。

如果有更复杂的需求（如动态修改参数），可能需要结合 QSignalMapper 或手动管理信号转发。

信号和槽函数多对多思想

QT中的槽函数其实在设计的时候就是一个比较独特的东西，它可以像MySQL那样，实现多对多（一个信号可以绑定多个槽函数，一个槽函数也可以被多个信号绑定）

我们可以再加一个信号：

#ifndef WIDGET_H
#define WIDGET_H

#include <QWidget>
#include <QString>
#include <QDebug>

QT_BEGIN_NAMESPACE
namespace Ui { class Widget; }
QT_END_NAMESPACE

class Widget : public QWidget
{
    Q_OBJECT

public:
    Widget(QWidget *parent = nullptr);
    ~Widget();
//槽函数
public slots:
    void myaction_1(const QString&);

//声明信号
signals:
    void mysignal_1(const QString&); //设置参数为QString
    void mysignal_2(const QString&); //再设置一个信号

private:
    Ui::Widget *ui;
};
#endif // WIDGET_H


#include "widget.h"
#include "ui_widget.h"
#include <QPushButton>

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{

    ui->setupUi(this);

    // 连接 Widget 的自定义信号到槽函数
    connect(this, &Widget::mysignal_1, this, &Widget::myaction_1);
    connect(this, &Widget::mysignal_2, this, &Widget::myaction_1);

    //发射信号
    emit Widget::mysignal_1("this this my text");
    emit Widget::mysignal_2("this this my text2");
}

//实现槽函数
void Widget::myaction_1(const QString& text)
{
    qDebug() << text;
}

Widget::~Widget()
{
    delete ui;
}

在这里插入图片描述
其实这种设计放到现在会有点冗余，因为现在一对一的关系可以完全满足要求了。但不过QT诞生的时代还没有足够的开发经验以供参考，所以做出这样的设计情有可原。

disconnect

disconnect顾名思义就是断开连接：

#include "widget.h"
#include "ui_widget.h"
#include <QPushButton>

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{

    ui->setupUi(this);

    // 连接 Widget 的自定义信号到槽函数
    connect(this, &Widget::mysignal_1, this, &Widget::myaction_1);
    disconnect(this, &Widget::mysignal_1, this, &Widget::myaction_1); //断开连接
    connect(this, &Widget::mysignal_2, this, &Widget::myaction_1);

    //发射信号
    emit Widget::mysignal_1("this this my text");
    emit Widget::mysignal_2("this this my text2");
}

//实现槽函数
void Widget::myaction_1(const QString& text)
{
    qDebug() << text;
}

Widget::~Widget()
{
    delete ui;
}

在这里插入图片描述

QT中使用lambda函数

我们使用connect的时候，最后一个参数其实我们是连接的一个函数，lambda是匿名函数，可以符合我们connect函数的参数要求：

#include "widget.h"
#include "ui_widget.h"
#include <QPushButton>

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);
    
    QPushButton* newbutton = new QPushButton(this);

    connect(newbutton,&QPushButton::clicked,this,[=]()
    {
        newbutton->setFixedSize(400,400);
        newbutton->setText("这是newbutton的文本");
        this->setWindowTitle("哈哈哈，我的标题已经改了");
    });
}

//实现槽函数
void Widget::myaction_1(const QString& text)
{
    qDebug() << text;
}

Widget::~Widget()
{
    delete ui;
}

在这里插入图片描述
在 Qt 的 connect 中使用 Lambda 表达式 可以方便地编写自定义槽函数，特别是在需要捕获局部变量或执行多行代码时。以下是代码片段及其 Lambda 表达式的详细解析：

Lambda 表达式基本结构

[ captures ] ( parameters ) -> return_type { body }

在你的代码中：

[=]() {
    newbutton->setFixedSize(400, 400);
    newbutton->setText("这是newbutton的文本");
    this->setWindowTitle("哈哈哈，我的标题已经改了");
}

对应部分：

  • [=]：捕获列表（Captures）
  • ()：参数列表（Parameters，此处为空）
  • {}：函数体（Body）

1. 捕获列表 [ ]

定义 Lambda 如何访问外部变量：

捕获方式说明
[=]按值捕获（隐式捕获所有外部变量，副本）
[&]按引用捕获（直接修改外部变量）
[this]捕获当前类的 this 指针（可访问成员变量/函数）
[a, &b]混合捕获：a 按值，b 按引用
[]不捕获任何外部变量

代码分析：
[=] 表示所有外部变量（如 newbutton、this）按值捕获（实际由于它们是指针，仍能修改指向的对象）。

2. 参数列表 ( )

定义 Lambda 的输入参数（类似于普通函数的参数）：

  • 如果连接的是无参数的信号（如 clicked()），参数列表可以为空 ()。
  • 如果信号有参数（如 clicked(bool checked)），则需要声明参数：
    connect(button, &QPushButton::clicked, this, [=](bool checked) {
    qDebug() << "按钮状态：" << checked;
});

你的代码分析：
clicked() 信号无参数，所以 () 为空。

3. 函数体 { }

Lambda 的具体实现逻辑（可以包含多行代码）。
代码分析：
在函数体中修改了按钮大小、文本和窗口标题：

{
    newbutton->setFixedSize(400, 400);      // 设置按钮大小
    newbutton->setText("这是newbutton的文本"); // 修改按钮文本
    this->setWindowTitle("哈哈哈，我的标题已经改了"); // 修改窗口标题
}

4. 返回值（可选）

如果 Lambda 有返回值，需通过 -> return_type 指定（你的例子中无返回值，可省略）。

常见用法示例

(1) 按值捕获局部变量
int count = 0;
connect(button, &QPushButton::clicked, this, [=]() {
    qDebug() << "当前计数：" << count; // 捕获的是 count 的副本
});
(2) 按引用捕获并修改局部变量
int count = 0;
connect(button, &QPushButton::clicked, this, [&]() {
    count++; // 直接修改外部变量
    qDebug() << "计数：" << count;
});
(3) 捕获 this 访问成员变量
class Widget : public QWidget {
    QString m_message = "Hello";
public:
    void setupButton() {
        connect(button, &QPushButton::clicked, this, [this]() {
            qDebug() << m_message; // 直接访问成员变量
        });
    }
};
(4) 带参数的 Lambda
connect(button, &QPushButton::toggled, this, [=](bool checked) {
    button->setText(checked ? "ON" : "OFF");
});

注意事项

  1. 生命周期问题：

    • 按引用捕获（[&]）时，需确保外部变量在 Lambda 执行时仍然有效（避免悬空引用）。
    • 按值捕获（[=]）更安全，但可能增加拷贝开销。

  2. 默认捕获 [=] 和 [&] 的风险：

    • 过度使用可能导致意外捕获不需要的变量（推荐显式指定捕获的变量，如 [this, button]）。

  3. Qt 信号槽与 Lambda：

    • Lambda 中可以直接调用类的成员函数（通过 [this] 捕获）。
    • 如果 Lambda 作为槽函数，确保其内部操作是线程安全的（跨线程时需小心）。

总结

  • [=]：安全捕获外部变量（副本），适合多数场景。
  • ()：根据信号参数决定是否声明参数。
  • {}：实现自定义逻辑，支持多行代码。
  • 最佳实践：显式列出需要捕获的变量（如 [this, newbutton]），避免隐式捕获带来的混淆。

通过 Lambda 表达式，你可以灵活地替代传统槽函数，尤其在需要快速响应信号并操作局部变量时非常方便。

QT —— 信号和槽（槽函数）
qq_67693066的博客
04-16 1089
QT —— 信号和槽（槽函数）
Qt——信号 和 槽
m0_64607843的博客
05-10 1119
上一篇虽然说到了信号和槽，这一篇就来看看信号和槽具体的机制。
QT基础入门——信号和槽机制（二）
嵌入式技术开发
10-04 2551
在Qt中，有一种回调技术的替代方法：那就是信号和槽机制。当特定事件发生时，会发出一个信号。Qt的小部件中有许多预定义的信号，但我们可以将小部件子类化，向它们添加自定义的信号。槽是响应特定信号的函数。
Qt 学习(四) —— 信号和槽
淋曦的进击手记
02-07 1250
1. 信号和槽的机制 当某个事件发生之后，比如，按钮检测到自己被点击了一下，它就会发出一个信号（signal）。这种发出是没有目的的，类似广播。如果有对象对这个信号感兴趣，它就会使用连接（connect）函数，将想要处理的信号和自己的一个函数（槽（slot））绑定并处理这个信号。 1.1. 信号和槽的属性 信号和槽都是函数。 但信号是类的成员函数。 而槽不仅可以是类的成员函数，还可以是静态函数、全...
C++客户端Qt开发——信号和槽
m0_63596031的博客
07-14 1279
在Qt中，用户和控件的每次交互过程称为一个事件。比如"用户点击按钮”是一个事件，"用户关闭窗口”也是一个事件。每个事件都会发出一个信号，例如用户点击按钮会发出"按钮被点击"的信号，用户关闭窗口会发出"窗口被关闭"的信号。Qt中的所有控件都具有接收信号的能力一个控件还可以接收多个不同的信号。对于接收到的每个信号，控件都会做出相应的响应动作。例如，按钮所在的窗口接收到"按钮被点击"的信号后，会做出"关闭自己”的响应动作
Qt——信号与槽
m0_73443478的博客
11-10 2478
Qt——信号与槽
Qt学习笔记——信号和槽
xyx0610的博客
02-12 954
案例：点击我的按钮 关闭窗口
QT——信号和槽学习笔记
qq_41885018的博客
07-30 885
signals:// 无参数信号// 带参数信号// 无参数槽// 带参数槽两个槽函数的声明：这是我定义的两个槽函数：信号（只需要signals声明）signals:connect函数连接：这部分是spinBox发出信号，接收者当前窗口，槽函数是onSpinBoxValueChanged然后当前窗口再发送信号，接收者是当前窗口，槽函数是onNumChanged这部分主要是实验一下自定义槽函数和信号，而不是直接使用valueChanged。
QT —— 信号和槽（自定义信号和槽函数）
qq_67693066的博客
04-16 996
QT —— 信号和槽（自定义信号和槽函数）
Hello Qt——Qt信号槽机制源码解析
天山老妖
03-07 2422
基于Qt4.8.6版本 一、信号槽机制的原理 1、信号槽简介 信号槽是观察者模式的一种实现，特性如下： A、一个信号就是一个能够被观察的事件，或者至少是事件已经发生的一种通知； B、一个槽就是一个观察者，通常就是在被观察的对象发生改变的时候——也可以说是信号发出的时候——被调用的函数； C、信号与槽的连接，形成一种观察者-被观察者的关系； D、当事件或者状态发生改变的时候，信号就会被发出；同时，信号发出者有义务调用所有注册的对这个事件（信号）感兴趣的函数（槽）。 信号和槽是多对多的关系。一个
【Qt】信号和槽——信号和槽的概念、信号和槽的使用、信号和槽的优缺点、自定义信号和槽、信号和槽的断开
Crocodile1006的博客
10-17 1455
Qt、信号和槽的概念、信号和槽的使用、信号和槽的优缺点、自定义信号和槽、信号和槽的断开
Qt 5——信号和槽机制
流楚丶格念的博客
06-19 4810
文章目录1.概念2.系统自带的信号和槽3. 自定义信号和槽自定义信号槽需要注意的事项：4.信号槽的拓展5.下面是信号与槽的简单代码示例： 1.概念 信号槽是 Qt 框架引以为豪的机制之一。所谓信号槽，实际就是观察者模式。当某个事件发生之后，比如，按钮检测到自己被点击了一下，它就会发出一个信号（signal）。这种发出是没有目的的，类似广播。如果有对象对这个信号感兴趣，它就会使用连接（connect）函数，意思是，将想要处理的信号和自己的一个函数（称为槽（slot））绑定来处理这个信号。也就是说，当信号发出被
QT——信号和槽
鲸落博客
06-13 780
Qt中的槽函数（Slot）是与信号（Signal）对应的概念，用于接收信号并执行特定的操作。使用时，与类的成员函数一样。信号成员会在满足一定条件时某个对象自动触发该对象的信号（触发条件可以通过QT帮助文档进行查看每个类中标示了signals的栏位），触发后程序会调用与信号相连接的槽函数。注：在用户平常的界面设计都基于QWidget类，当然该类是QObject的子类，因此也可以使用connect（）函数。当sender对象的signal信号触发时，receiver对象的method函数会自动调用。
qt 关闭窗口的槽函数_QT学习——父窗口，信号和槽机制
weixin_34621896的博客
01-30 1433
一、父窗口(容器窗口)1.概念：创建控件时可以指定停靠在父窗口上，如果没有指定，则飘在外面形成独立的窗体，父窗口本质也是图形控件，常用于表示父窗口类主要包括如下三个：QWidgetQDialog(对话框)QMainWindow(主窗口)注：QWidget和它的所有子类都可以作为父窗口，但是常用的父窗口类只有上面三个参考代码：#include #include #include int main(i...
Qt QComboBox 下拉复选多选（multicombobox）
csdndenglu的专栏
04-30 192
Qt QComboBox 下拉复选多选（multicombobox），备忘，待更多测试。
Qt 的信号与槽机制依赖元对象系统（Meta-Object System）实现
程序员黄老师的精品课！
04-30 91
在 Qt 中，信号和槽之间的连接主要通过 类及其相关的私有类进行管理。每个 实例都维护着一个指向其 的指针，该对象包含了有关类的所有元信息，包括信号、槽等。此外，还有一个关键的数据结构用于存储信号与槽之间的连接信息，即 结构体。 是 Qt 内部使用的一个结构体，用于表示单个信号到槽的连接。它通常包含以下字段：QMetaObject：包含类名、父类信息、属性列表、方法列表（包括信号和槽）、信号与槽的元信息等。它是 Qt 元对象系统的核心。QObjectPrivate： 类的私有部分，包含了一些对开发者
Qt帮助文档框架
最新发布
李习的博客
05-04 572
Qt自身支持帮助文档，所在的模块是qt help,因此想要在自己的程序中嵌入帮助文档是比较方便的（仅仅不用引入第三方包）。但是如同新手到了战场，无从下手，加之Qt自身的鸟语帮助文档，看不懂哦。网上对于Qt的开发资料相对匮乏，加之整个环境比较闭源，写出来的博文不是免费看的。至于QT的官方文档，我是看不懂。而且第一个代码段就是错的。重点Qt帮助项目收集生成压缩帮助文件所需的所有数据。除了诸如目录，索引关键字和帮助文档之类的实际帮助数据外，它还包含一些其他信息，例如用于标识帮助文件的名称空间。
【C++ Qt】快速上手 显⽰类控件（Label、LCDNumber、ProcessBar、CalendarWidget）
溟洵的博客
04-28 1395
本文围绕Qt中常用的显示类控件展开，重点讲解了 QLabel（文本/图片显示）、QLCDNumber（数字显示）、QProgressBar（进度条） 和 QCalendarWidget（日历控件） 的核心属性、使用场景及代码实例，帮助快速上手Qt界面开发中的基础显示功能。
QT6 源（68）：阅读与注释按钮类 QAbstractButton，及各种属性验证，QT 为按钮中的图片编码的过程，
zhangzhangkeji的博客
05-03 137
（1）（2）
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值