桌面应用 / 系统课时
定义并发送自定义信号
定义并发送自定义信号
本篇解决自定义 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 宏、信号参数与槽参数不匹配,以及在对象销毁后继续保存无效指针。
设计业务类时,可以先定义对象负责维护哪些状态,再确定哪些变化需要通知外部。信号越清晰,界面层和业务层之间的依赖越低。
按自己的节奏,确认真正理解。