桌面应用 / 系统课时

从 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 负责展示变化,两层之间通过清晰事件边界协作。

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

目录与阅读设置

阅读设置

17

记录一个想法

从 C++ 信号通知 QML 更新

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

登录哪都通