【QML使用C++类与接口 2】

使用 rootContext()->setContextProperty 方法可以将一个已经存在的C++对象直接暴露给QML。这种方法适用于那些不需要在QML中创建多个实例的对象，通常是单例模式或应用程序级别的对象。下面是一个详细的示例，展示如何使用 rootContext()->setContextProperty 将C++对象暴露给QML。

步骤 1：创建 C++ 类

首先，创建一个包含你要暴露给QML的功能的C++类。例如，我们创建一个名为 MyClass 的类，并为其添加一个简单的 greet 方法。

// MyClass.h
#ifndef MYCLASS_H
#define MYCLASS_H

#include <QObject>

class MyClass : public QObject {
    Q_OBJECT
public:
    explicit MyClass(QObject *parent = nullptr);

    Q_INVOKABLE QString greet(const QString &name);
};

#endif // MYCLASS_H

// MyClass.cpp
#include "MyClass.h"

MyClass::MyClass(QObject *parent) : QObject(parent) {}

QString MyClass::greet(const QString &name) {
    return QString("Hello, %1!").arg(name);
}

步骤 2：在 main.cpp 中设置上下文属性

接下来，在你的应用程序初始化代码中，将这个C++对象设置为QML上下文属性。例如，在 main.cpp 中：

#include <QGuiApplication>
#include <QQmlApplicationEngine>
#include <QQmlContext>
#include "MyClass.h"

int main(int argc, char *argv[]) {
    QGuiApplication app(argc, argv);

    QQmlApplicationEngine engine;

    // 实例化 C++ 对象
    MyClass myClass;

    // 将实例化的 C++ 对象设置为 QML 上下文属性
    engine.rootContext()->setContextProperty("myCppObject", &myClass);

    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    if (engine.rootObjects().isEmpty())
        return -1;

    return app.exec();
}

步骤 3：在 QML 中使用 C++ 对象

现在，你可以在QML中直接访问这个C++对象。在你的 main.qml 文件中：

import QtQuick 2.15
import QtQuick.Controls 2.15

ApplicationWindow {
    visible: true
    width: 640
    height: 480

    Text {
        text: myCppObject.greet("World")
        anchors.centerIn: parent
    }
}

在上面的代码中，我们直接使用了 myCppObject，并调用了它的 greet 方法。

总结

通过上述步骤，你可以使用 rootContext()->setContextProperty 方法将C++对象直接暴露给QML。这样做的好处是简单直接，适用于那些在QML中只需要一个实例的对象。关键步骤包括：创建C++类、在应用程序初始化时设置上下文属性、在QML中使用该属性。