答案：在Qt C++应用中，C++与QML交互可通过setContextProperty导出对象、qmlRegisterType注册可实例化类型、暴露属性信号时需注意Q_PROPERTY的NOTIFY信号和Q_INVOKABLE方法，单例对象可用qmlRegisterSingletonType注册，根据场景选择合适方式实现高效通信。
在Qt C++应用中，C++与QML的交互是构建现代UI应用的重要部分。通过将C++对象导出到QML，可以利用C++处理复杂逻辑、数据操作和性能敏感任务，同时使用QML实现流畅、灵活的用户界面。以下是几种常用方式将C++对象与属性暴露给QML使用。
1. 使用 setContextProperty 导出对象
最直接的方式是通过 QQmlContext::setContextProperty() 将C++对象绑定到QML上下文，使其在QML中可访问。
步骤：
- 创建一个继承自 QObject 的类，并使用 Q_PROPERTY 暴露属性，用 Q_INVOKABLE 或信号暴露方法。
- 在主函数或窗口初始化时，将该对象实例注册到QML上下文。
// dataobject.h
class DataObject : public QObject
{
Q_OBJECT
Q_PROPERTY(QString name READ name WRITE setName NOTIFY nameChanged)
public:
QString name() const { return m_name; }
void setName(const QString &name) {
if (m_name != name) {
m_name = name;
emit nameChanged();
}
}
signals:
void nameChanged();
private:
QString m_name;
};
// main.cpp
#include <QQmlApplicationEngine>
#include <QQmlContext>
int main(int argc, char *argv[])
{
QGuiApplication app(argc, argv);
DataObject obj;
obj.setName("Hello from C++");
QQmlApplicationEngine engine;
engine.rootContext()->setContextProperty("dataObj", &obj); // 关键：注册到上下文
engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
return app.exec();
}
在QML中即可直接使用：
立即学习“C++免费学习笔记（深入）”；
// main.qml
Text {
text: dataObj.name
}
2. 使用 qmlRegisterType 注册可实例化的类型
若希望在QML中像内置类型一样使用C++类（例如创建多个实例），应使用 qmlRegisterType。
优点： 支持在QML中使用 new DataObject 语法，适合组件化设计。
// main.cpp 中注册类型
qmlRegisterType<DataObject>("MyModule", 1, 0, "DataObject");
// main.qml
import MyModule 1.0
DataObject {
id: myData
name: "Registered Type"
}
Text {
text: myData.name
}
注意：必须在使用前调用 qmlRegisterType，通常在 main() 函数中完成。
3. 暴露属性与信号的细节
为了让QML正确响应C++端的变化，需注意以下几点：
- Q_PROPERTY 必须提供 NOTIFY 信号，否则QML无法感知属性变化。
- 信号和槽需使用 signals: 和 public slots: 声明。
- 方法若需被QML调用，应标记为 Q_INVOKABLE。
class Controller : public QObject
{
Q_OBJECT
Q_PROPERTY(int value READ value WRITE setValue NOTIFY valueChanged)
public:
Q_INVOKABLE void reset() { setValue(0); }
int value() const { return m_value; }
void setValue(int v) {
if (m_value != v) {
m_value = v;
emit valueChanged();
}
}
signals:
void valueChanged();
private:
int value = 0;
};
4. 单例对象的导出
对于全局配置、管理器等单例类，可使用 qmlRegisterSingletonInstance 或 qmlRegisterSingletonType。
// 注册单例实例
auto *singleton = new SettingsManager(engine);
engine.rootContext()->setContextProperty("settings", singleton);
// 或使用 qmlRegisterSingletonType 实现延迟初始化
QML中无需创建对象，直接使用：
Text {
text: settings.language
}
基本上就这些。关键是根据使用场景选择合适的方式：临时共享用 setContextProperty，组件复用用 qmlRegisterType，全局服务考虑单例。不复杂但容易忽略的是 NOTIFY 信号和 QObject 继承。 
