详解Qt中connect()函数

涩即是Null

已于 2024-06-20 10:14:15 修改

阅读量1.1k

点赞数 25

文章标签： qt 开发语言 c++

于 2024-06-16 17:00:00 首次发布

本文链接：https://blog.csdn.net/weixin_51418964/article/details/139705134

版权

一、基本概念

        要想了解connect() 函数，要先知道在Qt中什么是什么是信号（SIGNAL）和槽（SLOT）。

信号（SIGNAL）：指在特定情况下发射的通知。比如当我们点击了用户界面的一个按钮之后就发射了一个信号。

        槽（SLOT）：是指对信号进行响应的函数。也就是我们点击了一个按钮后我们要实现的功能。

        那么connect() 函数就是Qt 框架中用于将信号（SIGNAL）和槽（SLOT）关联起来的核心函数。

二、用法

1.旧版用法（Qt4和早期Qt5）

connect(sender, SIGNAL(signalName()), receiver, SLOT(slotName()));

sender：发射信号的对象名称
signalName()：信号名称
receiver：接收信号的对象名称，一般情况下为槽函数所属对象，写this即可
slotName()：槽函数名称

示例：

connect(button, SIGNAL(clicked()), this, SLOT(handleButtonClicked()));

注意： 如果信号与槽函数带参数还需要在函数括号内标出。

2.新版用法（推荐）

connect(sender, &SenderClass::signalName, receiver, &ReceiverClass::slotName);

这里引入了基于函数指针的语法，使得编译器可以进行更好的类型检查。但是这里有一个问题：与旧版的写法不同的是，信号与槽函数的参数怎么办？

首先我们知道，在 Qt 的信号与槽机制中，槽函数的参数不能多于信号的参数。也就是说，信号的参数可以多于槽的参数，且槽函数的参数必须是信号参数的一个子集。那么就可以分为如下三种情况：

1.信号和槽函数具有相同数量和类型的参数。这时可以直接连接且无需出现函数参数：

connect(lineEdit, &QLineEdit::textChanged, this, &Widget::do_textChanged);

在上面示例中，信号textChanged(QString)和槽函数do_textChanged(QString)参数相同。

2.信号的参数多于槽函数的参数。槽函数将忽略信号的多余参数，这个特性允许你在信号和槽参数不完全匹配的情况下，仍然能够正常工作。正常情况下，不推荐把槽函数设计为overload型。

3.某些信号的参数有默认值。也就是说同一信号的参数分为有参数和无参数，如QCheckBox的clicked()信号和clicked(bool)信号。这时connect()函数有两种写法：

a.设置不同名字的槽函数：

//槽函数
void do_checked(bool checked);
void do_checked_NoParam();

//connect()函数
connect(checkBox, &QCheckBox::clicked, this, &Widget::do_checked);
connect(checkBox, &QCheckBox::clicked, this, &Widget::do_checked_NoParam);

b.使用模板函数qOverload()来明确参数类型：

connect(checkBox, &QCheckBox::clicked, this, qOverload<bool>(&Widget::do_checked));
connect(checkBox, &QCheckBox::clicked, this, qOverload<>(&Widget::do_checked));

3.自动连接（无需使用connect()函数）

在构建项目时，若勾选了“Generate form”字段，则会生成一个后缀为“.ui”的文件。

那么在ui设计界面种可以选中一个对象，右键选择“Go to slot”或者“转到槽”，在弹出的对话框中再选择信号，那么就会自动生成一个槽函数。如果槽函数的名称符合相应的格式，Qt 会在运行时通过setupUi(this)自动生成connect()函数完成连接。

Dialog::Dialog(QWidget *parent)
    : QDialog(parent)
    , ui(new Ui::Dialog)
{
    //由go to slot生成的槽函数可以自动关联
    ui->setupUi(this);  

    //自定义槽函数需要手动关联
    connect(ui->radioButtonBlack,SIGNAL(clicked()),this,SLOT(do_setFontColor()));
}

//自动生成的槽函数格式：void on_<objectName>_<signalName>(){}
void Widget::on_btnCal_clicked()
{
    ...
}

//手动写的槽函数
void Widget::do_setFontColor()
{
    ...
}

当然在设计一些复杂功能时，自动连接方法就不太适用了。

4.Lambda表达式（Qt5.4）

lambda 表达式提供了一种非常灵活的方式来处理信号。有如下几个优点：

可以直接在连接语句中定义信号处理逻辑，无需在类中定义额外的槽函数。这在处理简单逻辑时尤其方便。
避免为每个信号处理逻辑定义新的槽函数，减少命名空间污染。
允许你在处理信号参数时，捕获外部变量或定义额外的处理逻辑。

基本格式如下：

connect(sender, &SenderClass::signalName, [lambda expression]);

举个栗子对比理解一下：

//方法一：使用槽函数指针连接
void processData(int value, QString message) {
    if (value > 10) {
        qDebug() << "Value is greater than 10:" << value << ", Message:" << message;
    } else {
        qDebug() << "Value is 10 or less:" << value;
    }
}

QObject::connect(&sender, &SenderClass::signalName, this, &ReceiverClass::processData);

//方法二：使用lambda表达式连接
QObject::connect(&sender, &SenderClass::signalName, [this](int value, QString message) {
    if (value > 10) {
        qDebug() << "Value is greater than 10:" << value << ", Message:" << message;
    } else {
        qDebug() << "Value is 10 or less:" << value;
    }
});

三、断开连接disconnect()

1.为什么使用disconnect()

使用connect()函数可以关联信号与槽，那么删除connect()函数不就可以断开连接了吗？

其实不然！我们最好使用官方的 disconnect() 函数来解除信号与槽的连接。原因有如下几点：

a.动态控制信号和槽的连接

有时你需要在运行时动态地控制信号和槽的连接。例如，你可能需要在某些情况下连接信号和槽，而在其他情况下断开它们。在这种情况下，使用 disconnect() 函数可以让你在需要时灵活地断开连接，而不需要修改代码来删除 connect() 调用。

b.保持代码的结构和可读性

connect() 调用通常在类的构造函数或初始化方法中设置，表示对象之间的关系和交互。将连接和断开连接的逻辑分开可以使代码更清晰、更具结构性。如果直接删除 connect() 调用，代码逻辑可能会变得混乱且难以维护。

c. 方便的调试和维护

使用 disconnect() 可以更方便地调试和维护代码。你可以在调试时临时断开某些连接，而无需删除和重新添加 connect() 调用。这样可以避免错误，并更容易地还原代码。

d. 多次连接和断开

在某些情况下，你可能会多次连接和断开相同的信号和槽。例如，当某个条件发生变化时，你希望断开以前的连接并建立新的连接。使用 disconnect() 可以确保你正确地断开之前的连接，而不会遗留下不需要的连接。

2.使用方法

a.解除与一个发射者所有信号的连接

disconnect(myObject, nullptr, nullptr, nullptr);
myObject->disconnect();

b.解除与一个特定信号的所有连接

disconnect(myObject, SIGNAL(mySignal), nullptr, nullptr);
myObject->disconnect(SIGNAL(mySignal));

c.解除与一个特定接收者的所有连接

disconnect(myObject, nullptr, myReceiver, nullptr);
myObject->disconnect( myReceiver);

d.解除特定的一个信号与槽的连接

disconnect(lineEdit, &QLineEdit::textChanged, label, &QLabel::setText);

四、细节问题

1. 一个信号可以连接到多个槽，所有连接的槽都会在信号发出时依次被调用。

connect(sender, &SenderClass::signalName, receiver1, &ReceiverClass1::slotName);
connect(sender, &SenderClass::signalName, receiver2, &ReceiverClass2::slotName);

2. 信号和槽机制是单向的，即信号发出时会调用槽函数，但槽函数中发出的信号不会自动调用其他槽函数，除非你明确连接了这些信号和槽。

写在最后：因自己学识浅薄，虽查找大量资料，仍有个别地方存在出入的话，还请读者不吝赐教！