桌面应用 / 系统课时
从 C++ 信号通知 QML 更新
从 C++ 信号通知 QML 更新
本节解决 C++ 后端状态变化后如何主动通知 QML 界面的问题。通过 Qt 信号槽机制,后台对象可以发布变化事件,QML 负责响应并更新显示内容。
学习目标
- 理解 C++ 信号在 QML 中的响应方式。
- 掌握属性变化信号与自定义信号的设计。
- 能构建后端驱动界面更新的基本模式。
使用信号连接界面和业务状态
QML 界面通常不应该循环查询 C++ 状态。更合理的方式是由 C++ 在状态变化时发出信号,QML 监听信号后执行刷新逻辑。
这种模式减少无效轮询,也让业务逻辑集中在 C++ 后端。
定义属性和变化信号
Qt 属性通常通过 Q_PROPERTY、读取方法和通知信号组成。属性变化时发出通知,QML 属性绑定会自动重新计算。
cpp
#include <QObject>
#include <QString>
class DownloadManager : public QObject
{
Q_OBJECT
Q_PROPERTY(int progress READ progress NOTIFY progressChanged)
public:
explicit DownloadManager(QObject *parent = nullptr) : QObject(parent) {}
int progress() const
{
return m_progress;
}
void setProgress(int value)
{
if (m_progress == value) {
return;
}
m_progress = value;
emit progressChanged();
}
signals:
void progressChanged();
private:
int m_progress = 0;
};预期输出
text
progress 从 0 更新到 50 时,QML 绑定的进度显示自动刷新。在 QML 中响应变化
当对象已经注册给 QML 后,可以直接绑定属性:
qml
ProgressBar {
value: downloadManager.progress / 100
}如果需要执行额外逻辑,可以使用信号处理器:
qml
Connections {
target: downloadManager
function onProgressChanged() {
console.log("progress:", downloadManager.progress)
}
}预期输出
text
progress: 50自定义信号传递事件
并非所有变化都适合作为属性。例如任务完成、错误发生、文件生成等一次性事件,更适合使用自定义信号。
cpp
signals:
void completed(const QString &filePath);QML 可以通过 Connections 接收事件,并决定是否显示提示、刷新列表或跳转页面。
信号设计注意事项
C++ 发出的信号应该表达业务事件,而不是暴露内部执行过程。例如,不推荐连续发送“第 1 步完成”“第 2 步完成”等内部状态,除非界面确实需要展示这些阶段。
同时要避免频繁发送无意义更新。对于高频数据,应考虑合并更新、降低通知频率,避免大量 QML 重绘影响界面性能。
通过信号驱动更新后,C++ 负责产生可信状态,QML 负责展示变化,两层之间通过清晰事件边界协作。
按自己的节奏,确认真正理解。