Qt5中从C++动态创建QML Item触发ReferenceError问题求助

核心问题 #

这不是所有权问题，而是QML上下文可见性导致的：

• QML中通过Qt.createComponent().createObject(toastContainer)创建组件时，会自动继承调用者所在的上下文（即toastContainer的子上下文），因此能访问到该上下文内的globals对象。
• 而C++中直接调用component.create()时，默认使用QML引擎的根上下文，但你的globals是定义在main.qml里toastContainer的子上下文中，根上下文并没有这个对象，所以触发ReferenceError。

解决方案 #

方案1：将globals注册到引擎根上下文（推荐，适合全局通用变量） #

把globals对象放到QML引擎的根上下文中，让所有QML组件都能直接访问它，有两种实现方式：

方式A：C++直接注册全局属性

在初始化QQuickView时，将颜色属性直接注册到根上下文：

// 初始化QQuickView的代码段
QQuickView* view = new QQuickView;
QQmlContext* rootCtx = view->rootContext();
// 直接注册颜色属性，也可以封装成QObject类传递
rootCtx->setContextProperty("rsRed", QColor("#BE1622"));
// 同时修改ToastNotification.qml中的color为：color: rsRed

方式B：将QML中的globals传递到C++并注册

如果要保留QML中定义的globals，先给QML里的globals加上objectName: "globals"，再在C++中获取并注册到根上下文：

// 获取QML中的globals对象
QObject* globals = mQuickView->rootObject()->findChild<QObject*>("globals");
if (globals) {
    mQuickView->rootContext()->setContextProperty("globals", globals);
}

方案2：创建组件时传入正确的上下文 #

在C++中创建组件时，传入toastContainer所在的上下文，让组件能访问到该上下文内的globals：

QObject* ToastNotificationManager::createToast(const QString& message)
{
    QQmlComponent component(mQuickView->engine(), QUrl("qrc:/qml/ToastNotification.qml"), QQmlComponent::PreferSynchronous);

    // 先给QML中的toastContainer加上objectName: "toastContainer"
    QObject* toastContainer = mQuickView->rootObject()->findChild<QObject*>("toastContainer");
    QQmlContext* containerCtx = qmlContext(toastContainer);

    // 使用指定上下文创建组件
    QObject* toast = component.create(containerCtx);

    if (toast) {
        toast->setProperty("message", message);
        // 设置视觉父节点
        QQuickItem* toastItem = qobject_cast<QQuickItem*>(toast);
        QQuickItem* containerItem = qobject_cast<QQuickItem*>(toastContainer);
        if (toastItem && containerItem) {
            toastItem->setParentItem(containerItem);
        }
    }

    return toast;
}

方案3：给ToastNotification添加独立属性（解耦上下文依赖） #

修改ToastNotification.qml，添加独立的颜色属性，创建时从外部传入，彻底摆脱对globals的依赖：

Rectangle {
    id: toast
    property alias message: text.text
    // 添加自定义颜色属性
    property color toastColor: "#BE1622"

    implicitWidth: text.implicitWidth + 20
    implicitHeight: text.implicitHeight + 20

    color: toastColor

    Text {
        id: text
        anchors.centerIn: parent
        text: "I'm a toast notification... yay..."
    }    
}

然后在C++创建时设置该属性：

if (toast) {
    toast->setProperty("message", message);
    toast->setProperty("toastColor", QColor("#BE1622"));
}

内容的提问来源于stack exchange，提问作者Ponzifex