Qt6入门教程 8：信号和槽机制（连接方式）

一.一个信号与槽连接的例子

二.第五个参数

1.Qt::AutoConnection

2.Qt::DirectConnection

3.Qt::QueuedConnection

4.Qt::BlockingQueuedConnection

5.Qt::UniqueConnection

三.信号

四.connect函数原型

五.信号与槽的多种用法

六.槽的属性

一.一个信号与槽连接的例子

#include <QObject>
#include <QDebug>

class Counter : public QObject
{
    Q_OBJECT

public:
    Counter() { m_value = 0; }

    int value() const
    {
        return m_value;
    }

public slots:
    void setValue(int value)
    {
        if (value != m_value)
        {
            m_value = value;
            emit valueChanged(value);
        }
    }

signals:
    void valueChanged(int newValue);

private:
    int m_value;
};

int main(int argc, char *argv[])
{
    Counter a, b;
    QObject::connect(&a, &Counter::valueChanged,
                     &b, &Counter::setValue);

    a.setValue(12); // a.value() == 12, b.value() == 12
    qDebug() << "a: " << a.value() << " b: " << b.value();
    b.setValue(48); // a.value() == 12, b.value() == 48
    qDebug() << "a: " << a.value() << " b: " << b.value();


    return 0;
}

#include "main.moc"

在调用a.setValue(12)时会发送valueChanged(12)信号，此时槽函数b.setValue(12)会被调用。然后b也会发送valueChanged(12)信号，但是由于没有槽连接到这个信号，所以这个信号被忽略了，不做处理。
需要注意的是，在setValue()函数中在赋值和发送信号之前做了 value != m_value的判断。这样做是为了防止特定情况下触发的无限循环调用，比如此时b.valueChanged()连接到了a.setValue()。

二.第五个参数

在上面的例子中，调用connect()函数时并没有指定第五个参数，因第五个参数一般不填，为默认值。

1.Qt::AutoConnection

默认值，使用这个值则连接类型会在信号发送时决定。如果接收者和发送者在同一个线程，则自动使用Qt::DirectConnection类型。如果接收者和发送者不在一个线程，则自动使用Qt::QueuedConnection类型。

2.Qt::DirectConnection

槽函数会在信号发送的时候直接被调用，槽函数和信号发送者在同一线程。效果看上去就像是直接在信号发送位置调用了槽函数，同步执行。
emit语句后面的代码将在与信号关联的所有槽函数执行完毕后才被执行。
无论槽函数所属对象在哪个线程，槽函数都在发射信号的线程内执行。但需要注意的是，当信号和槽在不同的线程时，Qt::DirectConnection连接方式是不安全的，就像不能直接调用不同线程中的函数一样。但QObject::connect() 方法本身是线程安全的。

3.Qt::QueuedConnection

信号发出后，信号会暂时被放到一个消息队列中，需等到接收对象所属线程的事件循环取得控制权时才取得该信号，然后执行和信号关联的槽函数，这种方式既可以在同一线程内传递消息也可以跨线程操作。
emit语句后的代码将在发出信号后立即被执行，无需等待槽函数执行完毕。
槽函数在接收者所依附线程执行。

4.Qt::BlockingQueuedConnection

槽函数的调用时机与Qt::QueuedConnection一致，不过发送完信号后发送者所在线程会阻塞，直到槽函数运行完。而且接收者和发送者绝对不能在一个线程，否则程序会死锁。在多线程间需要同步的场合可能需要这个。

// Qt部分源码如下
.....//其他代码
else if(type == Qt::BlockingQueuedConnection)
{
    if(currentThread == objectThread) // 如果是同一条线程，就死锁了
        qWarning("QMetaObject::invoke: Dead lock detected");
 
    QSemaphore semaphore; // 信号量
    QCoreApplication::postEvent(Object, new QMetaCallEvent(slot, 0, -1, 0, 0, qrgv, &semaphore));  // 将函数指针、函数参数、信号量的指针发送到事件队列
    semaphore.acquire(); // 默认形参为1,；获取1个数据，如果没有准备1个好数据，则阻塞
}
else
{
.... //其他代码
}

5.Qt::UniqueConnection

这个flag可以通过按位或（|）与以上四个结合在一起使用。当这个flag设置时，当某个信号和槽已经连接时，再进行重复的连接就会失败。也就是为了避免重复连接。

三.信号

声明信号使用signals关键字，发送信号使用emit关键字。
注意点:
1.所有的信号声明都是公有的，所以Qt规定不能在signals前面加public、private、protected。
2.所有的信号都没有返回值，所以返回值都用void。
3.所有的信号都不需要定义。
4.必须直接或间接继承自QOBject类，并且开头私有声明包含Q_OBJECT。
5.在同一个线程中，当一个信号被emit发出时，会立即执行其槽函数，等槽函数执行完毕后，才会执行emit后面的代码，如果一个信号链接了多个槽，那么会等所有的槽函数执行完毕后才执行后面的代码，槽函数的执行顺序是按照它们链接时的顺序执行的。不同线程中（即跨线程时），槽函数的执行顺序是随机的。
6.在链接信号和槽时，可以设置链接方式为：在发出信号后，不需要等待槽函数执行完，而是直接执行后面的代码，是通过connect的第5个参数。
7.信号与槽机制要求信号和槽的参数一致，所谓一致，是参数类型一致。如果不一致，允许的情况是，信号的参数可以比槽函数的参数多，即便如此，槽函数存在的那些参数的顺序也必须和信号的前面几个一致起来。这是因为，你可以在槽函数中选择忽略信号传来的数据（也就是槽函数的参数比信号的少），但是不能说信号根本没有这个数据，你就要在槽函数中使用（就是槽函数的参数比信号的多，这是不允许的）。

四.connect函数原型

1.如：connect(pushButton, SIGNAL(clicked()), dialog, SLOT(close()));Qt4和Qt5都可以使用这种连接方式。

static QMetaObject::Connection connect(
    const QObject *sender,    //信号发送对象指针
    const char *signal,       //信号函数字符串，使用SIGNAL()
    const QObject *receiver,  //槽函数对象指针
    const char *member,       //槽函数字符串，使用SLOT()
    Qt::ConnectionType = Qt::AutoConnection);

2.如：connect(pushButton, &QPushButton::clicked, dialog, &QDialog::close);这是Qt5新增的连接方式，在编译期间就可以进行类型检查，推荐使用这种连接方式。

static QMetaObject::Connection connect(
    const QObject *sender,      //信号发送对象指针
    const QMetaMethod &signal,  //信号函数地址
    const QObject *receiver,    //槽函数对象指针
    const QMetaMethod &method,  //槽函数地址
    Qt::ConnectionType type = Qt::AutoConnection);

3.两者的对比

概述	基于字符串的语法	基于函子的语法
做类型检查的阶段	运行时	编译时
是支持行类型的隐式转换		是
是否支持信号连接到lambda表达式		是
是否支持槽的参数比信号的参数多（此时槽使用默认参数）	是
是否支持连接C++函数到QML函数	是

注：qt5之后，这种新型的写法，支持所有的函数类型，无需定义slots关键字也可以。

如何选择重载的信号和槽呢？例如，QLCDNumber有三个版本的display()槽：
●QLCDNumber::display(int)
●QLCDNumber::display(double)
●QLCDNumber::display(QString)
将槽连接到int版本的QSlider::valueChanged()信号, 两种语法的写法如下:

auto slider = new QSlider(this);
auto lcd = new QLCDNumber(this);

// 基于字符串的语法
connect(slider, SIGNAL(valueChanged(int)),
        lcd, SLOT(display(int)));

// 基于函子的语法，第一种方式（推荐）
connect(slider, &QSlider::valueChanged,
        lcd, static_cast<void (QLCDNumber::*)(int)>(&QLCDNumber::display));

// 基于函子的语法，第二种方式
void (QLCDNumber::*mySlot)(int) = &QLCDNumber::display;
connect(slider, &QSlider::valueChanged,
        lcd, mySlot);

// 基于函子的语法，第三种方式
connect(slider, &QSlider::valueChanged,
        lcd, QOverload<int>::of(&QLCDNumber::display));

// 基于函子的语法，第四种方式(C++14)
connect(slider, &QSlider::valueChanged,
        lcd, qOverload<int>(&QLCDNumber::display));

在需要信号发送方信息的情况下，Qt提供了QObject::sender()函数，它返回一个指向发送信号的对象的指针。如下所示：

void MyWidget::on_pushButton_clicked()
{
    QPushButton *button = static_cast<QPushButton*>(QObject::sender());
    qDebug() << button->text(); 
}

五.信号与槽的多种用法

1.一个信号可以和多个槽相连
2.多个信号可以连接到一个槽
3.一个信号可以连接到另外的一个信号
4.槽可以被取消链接.
其写法和connect一样，只需要将connect换成disconnect即可。
disconnect() 通常以三种方式使用，如下面的示例所示：
1.断开myObject对象的信号与其他对象间的连接，使用后myObject发出的信号没有对应的槽函数进行响应

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

2.断开myObject对象的mySignal()信号与其他对象间的连接，使用后myObject发出的mySignal()信号没有对应的槽函数进行响应

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

3.断开myObject对象的与myReceiver对象间的连接，使用后myObject发出mySignal()信号myReceiver没有对应的槽函数进行响应

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

六.槽的属性

public slots：在这个区内声明的槽意味着所有对象都可将信号和之相连接。这对于组件编程非常有用，你能创建彼此互不了解的对象，将他们的信号和槽进行连接以便信息能够正确的传递。
protected slots：在这个区内声明的槽意味着当前类及其子类能将信号和之相连接。
private slots：在这个区内声明的槽意味着只有类自己能将信号和之相连接。
注：信号和槽不能携带模板类参数

原文链接：https://blog.csdn.net/caoshangpa/article/details/135639126