桌面应用 / 系统课时

定义并发送自定义信号

定义并发送自定义信号

本篇解决自定义 Qt 对象如何主动通知其他对象状态变化的问题。通过声明 signal 并使用 emit 发送事件,可以让业务逻辑与界面更新保持松耦合,适用于进度通知、状态变化和异步结果回传等场景。

学习目标

  • 理解 Qt 信号声明的规则和适用场景
  • 掌握在 QObject 子类中定义并发送自定义信号的方法
  • 能够将业务对象状态变化通知到界面层

自定义信号解决的问题

在桌面应用中,业务对象通常不应该直接操作窗口控件。例如文件下载对象只需要知道下载进度发生变化,而不需要依赖进度条控件的具体实现。

Qt 的 signal 机制允许对象声明“发生了某件事”,其他对象通过连接槽函数决定如何响应。发送方只负责发出通知,不关心接收方数量和处理方式。

声明 signal 与发送通知

自定义信号需要定义在继承自 QObject 的类中,并使用 Qt 的 signals 关键字声明。发送信号时使用 emit 关键字,参数会传递给所有已连接的槽函数。

cpp
#include <QObject>

class DownloadTask : public QObject
{
    Q_OBJECT

public:
    explicit DownloadTask(QObject *parent = nullptr)
        : QObject(parent)
    {
    }

    void updateProgress(int value)
    {
        m_progress = value;
        emit progressChanged(m_progress);
    }

signals:
    void progressChanged(int value);

private:
    int m_progress = 0;
};

上面的类片段展示了一个业务对象发送进度变化通知的方式。实际项目中,信号通常只描述事件事实,例如“进度已变化”“数据已加载完成”,而不是直接包含界面操作。

连接自定义信号

自定义信号与普通信号一样,通过 QObject::connect 建立连接。接收对象可以是窗口类、控制器类或其他业务对象。

cpp
#include <QDebug>

DownloadTask task;

QObject::connect(&task, &DownloadTask::progressChanged,
                 [](int value) {
                     qDebug() << "progress:" << value;
                 });

task.updateProgress(80);

预期输出

text
progress: 80

这里使用 Lambda 作为槽函数,适合简单响应逻辑。复杂界面项目中,通常会连接到 QWidget 或其他 QObject 子类的方法。

使用自定义信号时的边界

自定义信号应该表达对象状态变化,而不是替代普通函数调用。如果调用方需要立即获得返回值,应该使用函数;如果只是通知多个对象某个事件发生,signal 更合适。

常见错误包括忘记继承 QObject、缺少 Q_OBJECT 宏、信号参数与槽参数不匹配,以及在对象销毁后继续保存无效指针。

设计业务类时,可以先定义对象负责维护哪些状态,再确定哪些变化需要通知外部。信号越清晰,界面层和业务层之间的依赖越低。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定义并发送自定义信号

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通