《Qt信号与槽机制》详解：从基础到实践

一、信号与槽的核心概念

Qt框架的信号与槽（Signals and Slots）机制是对象间通信的核心工具，也是Qt区别于其他开发框架的标志性特性。其本质是函数之间的动态绑定 ：当一个对象的状态发生变化时，会发出一个信号（Signal）；另一个对象则通过**槽（Slot）**响应这个信号并执行对应操作。

1.1 什么是Qt对象？

信号与槽的通信依赖于QObject类及其派生类的对象。例如：

QPushButton（按钮）
QLineEdit（文本框）
QMainWindow（主窗口）
QTimer（定时器）

这些对象均继承自QObject，具备接收和发射信号的能力。

二、信号与槽的本质

2.1 信号（Signal）

定义：信号是对象状态变化的事件通知，本质是一个无实现的函数声明。
触发方式 ：通过emit关键字触发。

示例：

cpp 复制代码

class MyButton : public QPushButton {
    Q_OBJECT
signals:
    void customSignal(int value); // 自定义信号
};

2.2 槽（Slot）

定义：槽是响应信号的普通成员函数，可以像普通函数一样调用，也可以与信号动态绑定。
特点：
- 必须声明在public slots、protected slots或private slots中。
- 可以有参数和返回值，支持重载。

示例：

cpp 复制代码

class MyWindow : public QWidget {
    Q_OBJECT
private slots:
    void handleSignal(int value); // 自定义槽函数
};

三、信号与槽的连接方式

Qt提供了多种连接方式，开发者可根据需求选择：

3.1 手动连接（推荐）

通过QObject::connect()函数显式绑定信号与槽：

cpp 复制代码

connect(sender, SIGNAL(signalName(参数类型)), 
        receiver, SLOT(slotName(参数类型)));

示例：

cpp 复制代码

QPushButton *btn = new QPushButton("Click Me");
connect(btn, SIGNAL(clicked()), this, SLOT(close()));
// 点击按钮后关闭窗口

3.2 自动连接（Qt Designer）

在Qt Designer中右键控件 -> 转到槽，自动生成槽函数并自动绑定：

规则：槽函数名遵循on_控件名_信号名()格式。

示例：

cpp 复制代码

// 自动生成的槽函数
void MainWindow::on_pushButton_clicked() {
    this->hide(); // 点击按钮后隐藏窗口
}

3.3 高级连接方式

3.3.1 函数指针（Qt5+推荐）

cpp 复制代码

connect(btn, &QPushButton::clicked, this, &MyWindow::handleSignal);

优势：编译期检查信号/槽签名，避免运行时错误。

3.3.2 Lambda表达式（Qt5+）

cpp 复制代码

connect(btn, &QPushButton::clicked, [=]() {
    qDebug() << "Button clicked!";
});

优势：代码简洁，支持内联逻辑。

四、自定义信号与槽

4.1 自定义信号

声明：在头文件中使用signals:关键字。
触发：通过emit关键字触发信号。
示例：

cpp 复制代码

// mybutton.h
class MyButton : public QPushButton {
    Q_OBJECT
signals:
    void valueChanged(int newValue); // 自定义信号
};

// mybutton.cpp
void MyButton::doSomething() {
    emit valueChanged(42); // 触发信号
}

4.2 自定义槽

声明：在头文件中使用slots:关键字。
定义：在源文件中实现槽函数。
示例：

cpp 复制代码

// mywindow.h
class MyWindow : public QWidget {
    Q_OBJECT
private slots:
    void onValueChanged(int value); // 自定义槽
};

// mywindow.cpp
void MyWindow::onValueChanged(int value) {
    qDebug() << "Received value:" << value;
}

五、信号与槽的连接类型

connect()函数的第五个参数Qt::ConnectionType决定了通信行为：

类型	描述	适用场景
`Qt::AutoConnection`	默认值，自动选择连接类型	通用场景
`Qt::DirectConnection`	信号触发时立即调用槽	同一线程通信
`Qt::QueuedConnection`	槽在接收者线程的事件循环中调用	跨线程通信
`Qt::BlockingQueuedConnection`	阻塞发送线程直到槽执行完毕	线程同步
`Qt::UniqueConnection`	避免重复连接	防止多连接

示例：

cpp 复制代码

connect(worker, &Worker::dataReady, 
        this, &MainWindow::updateUI,
        Qt::QueuedConnection); // 跨线程安全通信

六、典型应用场景

6.1 按钮与窗口交互

cpp 复制代码

QPushButton *btn = new QPushButton("Close");
connect(btn, &QPushButton::clicked, qApp, &QApplication::quit);
// 点击按钮退出应用程序

6.2 数据更新通知

cpp 复制代码

class DataModel : public QObject {
    Q_OBJECT
signals:
    void dataUpdated(const QString &newData);
};

class View : public QWidget {
    Q_OBJECT
private slots:
    void updateView(const QString &data) {
        label->setText(data);
    }
};

七、常见问题与技巧

7.1 信号与槽的参数匹配

规则：槽函数参数可少于信号参数（多余参数会被忽略），但类型必须匹配。

示例：

cpp 复制代码

connect(sender, SIGNAL(valueChanged(int, QString)), 
        receiver, SLOT(handleValue(int))); // 只接收int参数

7.2 自定义类型参数

若信号/槽使用自定义类型，需注册元类型：

cpp 复制代码

Q_DECLARE_METATYPE(MyCustomType)
qRegisterMetaType<MyCustomType>("MyCustomType");

7.3 信号与槽的断开

cpp 复制代码

disconnect(sender, SIGNAL(signal), receiver, SLOT(slot));
// 或断开所有连接
disconnect(receiver);

八、总结

信号与槽机制是Qt开发的核心，其灵活性和安全性使得对象间通信既高效又直观。掌握以下要点将显著提升开发效率：

优先使用函数指针或Lambda表达式（Qt5+推荐）。
跨线程通信时使用Qt::QueuedConnection。
避免信号/槽参数不匹配导致的运行时错误。