Qt 实战（4）信号与槽 | 4.2、自定义信号与槽

前言：

在Qt框架中，信号（signals）和槽（slots）机制是对象间通信的核心。这种机制允许对象在特定事件发生时发出信号，而其他对象可以连接这些信号到它们的槽函数上，以响应这些事件。Qt提供了许多内置的信号和槽，但开发者也可以自定义信号和槽来满足特定的需求。本文将介绍如何在Qt中自定义信号与槽。

一、自定义信号与槽

1、自定义信号

在Qt中，自定义信号通常在一个继承自QObject或其子类的类中进行。自定义信号在类声明中以signals关键字开头，并且没有返回类型，但可以有任意数量的参数。信号本身不实现任何功能，它们只是用于在对象之间传递事件。以下是一个自定义信号的示例：

class MyObject : public QObject
{
    Q_OBJECT

public:
    // ... 其他成员函数 ...

signals:
    void mySignal(int value); // 自定义信号，带一个int类型参数

    // 注意：信号没有实现体（即没有函数体），且返回类型为void
};

在上面的代码中，MyObject类继承自QObject，并声明了一个名为mySignal的自定义信号。这个信号接受一个int类型的参数。

自定义信号时，需要注意下面几点：

• 要使用关键字signals
• 只需要声明不需要实现
• 信号函数返回值是void
• 信号函数可以重载

2、触发信号

emit关键字用于触发（或“发射”）一个信号（Signal）。当某个事件或条件满足时，一个对象可以使用emit关键字来通知其他对象，这些对象通过连接（Connect）到该信号来接收通知。

void MyObject::someFunction()  
{  
    // ... 一些代码 ...  
  
    int newValue = 42; // 假设这是你想要传递的新值  
    emit mySignal(newValue); // 发射信号，并传递值给连接的槽  
  
    // ... 其他代码 ...  
}

3、自定义槽

槽函数与普通的成员函数类似，但有一个特殊点：它们可以用作Qt信号的目标。槽函数可以有返回值，也可以没有，并且可以有任何数量的参数。槽函数可以在任何继承自QObject或其子类的类中定义。以下是一个自定义槽的示例：

class MyObject : public QObject
{
    Q_OBJECT

public:
    // ... 其他成员函数 ...

public slots:
    void mySlot(int value) {
        // 处理信号的逻辑
        qDebug() << "Received value:" << value;
    }

    // ... 其他槽函数 ...
};

在上面的代码中，MyObject类定义了一个名为mySlot的槽函数。这个函数接受一个int类型的参数，并在控制台输出接收到的值。

4、连接信号与槽

在Qt中，信号和槽之间的连接是通过QObject::connect函数实现的。这个函数接受四个参数：发出信号的对象的指针、信号的名称、接收信号的对象的指针、以及槽函数的名称。以下是一个连接信号与槽的示例：

MyObject *sender = new MyObject();
MyObject *receiver = new MyObject();

// 连接sender的mySignal信号到receiver的mySlot槽
QObject::connect(sender, &MyObject::mySignal, receiver, &MyObject::mySlot);

// 某个地方触发信号
emit sender->mySignal(42); // 这将调用receiver的mySlot函数，并传递值42

在上面的代码中，我们首先创建了两个MyObject对象：一个作为信号的发射者（sender），另一个作为信号的接收者（receiver）。然后，我们使用QObject::connect函数将sender的mySignal信号连接到receiver的mySlot槽。最后，我们通过emit关键字触发sender的mySignal信号，并传递一个整数值42。这将导致receiver的mySlot函数被调用，并输出接收到的值。

5、总结

Qt的信号和槽机制提供了一种灵活且类型安全的方式来处理对象间的通信。通过自定义信号和槽，开发者可以根据应用程序的具体需求来定义事件和响应。在Qt中自定义信号和槽非常简单，只需在类中声明它们，并使用QObject::connect函数将它们连接起来即可。