QML与C++交互的两种注册方法比较（rootContext 和 qmlRegisterType）

在main.cpp实例化对象调用的过程中，注册是常见的操作之一，目前接触到的方法有两种，两者的目的和使用方式是不同的，通过代码可以直观的
看出来：

int main(int argc, char *argv[])
{
#if QT_VERSION < QT_VERSION_CHECK(6, 0, 0)
    QCoreApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
#endif

    QGuiApplication app(argc, argv);

    QQmlApplicationEngine engine;
    //注册方法1
    engine.rootContext()->setContextProperty("MyListModel", MyListModel::getInstance());
	//注册方法2
	qmlRegisterType<MyListModel>("ListMod", 1, 0, "MyListModel");

    const QUrl url(QStringLiteral("qrc:/main.qml"));
    QObject::connect(&engine, &QQmlApplicationEngine::objectCreated,
                     &app, [url](QObject *obj, const QUrl &objUrl) {
        if (!obj && url == objUrl)
            QCoreApplication::exit(-1);
    }, Qt::QueuedConnection);
    engine.load(url);

    return app.exec();
}

qmlRegisterType

qmlRegisterType 是一个函数，用于在 QML 引擎中注册 C++ 类型，使得 QML 文件中可以直接使用这些类型。这个函数通常在 C++ 代码中调用，用于将自定义的 C++ 类（特别是那些继承自 QObject 的类）暴露给 QML。

• 优点：
  • QML 文件中可以直接使用注册的类型，创建其实例，并与其进行交互。
  • 支持类型安全，QML 编辑器（如 Qt Creator）可以提供自动补全和类型检查。
  • 适用于需要多个实例的情况，因为 QML 可以直接创建和管理这些实例。
• 缺点：
  • 需要 C++ 类与 QML 之间进行明确的类型匹配。
  • 如果类具有复杂的构造函数或需要特定的初始化逻辑，可能需要额外的设置。

在给出的例子中：

qmlRegisterType<MyListModel>("ListMod", 1, 0, "MyListModel");

这里注册了一个名为 MyListModel 的 C++ 类，它在 QML 中的导入模块为 “ListMod”，版本为 1.0，并且可以直接在 QML 中通过 MyListModel 类型名来创建和使用实例。

setContextProperty

setContextProperty 是一个方法，用于将 C++ 对象或值设置为 QML 上下文的属性，这样 QML 文件中就可以通过属性名直接访问它。这通常用于将单例或全局对象暴露给 QML。

• 优点：
  • 简单直接，适用于将单例或全局对象暴露给 QML。
  • 不需要复杂的类型匹配或注册。
• 缺点：
  • 不支持类型安全，QML 编辑器可能无法提供自动补全或类型检查。
  • 只能在 QML 文件中访问一个特定的实例（通常是单例）。

在给出的例子中：

engine.rootContext()->setContextProperty("MyListModel", MyListModel::getInstance());

这里将 MyListModel 的单例实例设置为 QML 上下文的属性，名为 “MyListModel”。在 QML 文件中，可以直接通过 MyListModel 这个属性名来访问这个单例实例。

风险验证

//cpp
QScreen *screen = QGuiApplication::primaryScreen();
engine.rootContext()->setContextProperty("screen_WIDTH",800);

//qml
property int screen_width: 200
width: screen_WIDTH

此时的宽度是800还是200呢？是200

总结

• qmlRegisterType 用于注册 C++ 类型，以便 QML 可以直接创建和使用这些类型的实例。
• setContextProperty 用于将 C++ 对象或值设置为 QML 上下文的属性，以便 QML 可以直接访问它们。这通常用于单例或全局对象。
• 不建议使用setContextProperty ，因为当全局和局部遇到重名时，会直接覆盖掉，这对于程序来说是非常危险的。
• 性能方面qmlRegisterType 会稍好一点