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

在QML中调用C++接口是一个常见的需求，通常用于将高效的C++逻辑与灵活的QML界面结合起来。QML和C++的互操作性是通过Qt的元对象系统（Meta-Object System）和信号槽机制实现的。以下步骤详细说明了如何在QML中调用C++接口。

步骤 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);
}

注意 Q_INVOKABLE 关键字，它使得这个方法可以从QML中调用。

步骤 2：注册 C++ 类型到 QML

然后，在你的应用程序初始化代码中，将这个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++ 类
    qmlRegisterType<MyClass>("com.example", 1, 0, "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
import com.example 1.0

ApplicationWindow {
    visible: true
    width: 640
    height: 480

    MyClass {
        id: myCppObject
    }

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

在上面的代码中，我们实例化了 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);
}

main.cpp

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

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

    QQmlApplicationEngine engine;

    qmlRegisterType<MyClass>("com.example", 1, 0, "MyClass");

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

    return app.exec();
}

main.qml

import QtQuick 2.15
import QtQuick.Controls 2.15
import com.example 1.0

ApplicationWindow {
    visible: true
    width: 640
    height: 480

    MyClass {
        id: myCppObject
    }

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

总结

通过上述步骤，你可以在QML中调用C++接口。关键步骤包括：创建C++类、注册C++类型到QML、在QML中实例化并使用C++类。Qt的元对象系统和信号槽机制使得这种跨语言调用变得相对简单和高效。