如何使QQuickView直接加载字符串形式的QML源码而非外部文件？

QQuickView本身没有提供像QQmlComponent::setData()那样直接传入源码的方法，但可以通过以下两种方式实现直接加载inline QML源码：

方法一：通过QQmlComponent创建实例并绑定到QQuickView #

利用QQuickView自带的QML引擎创建组件，加载源码后将实例化的根对象设置为QQuickView的内容：

#include <QGuiApplication>
#include <QQuickView>
#include <QQmlComponent>
#include <QQuickItem>
#include <QDebug>

int main(int argc, char *argv[])
{
    QGuiApplication qtapp(argc, argv);
    QQuickView rootView;
    rootView.setResizeMode(QQuickView::SizeRootObjectToView);

    // 定义inline QML源码
    const QString qmlSource = R"(
        import QtQuick 2.15
        Rectangle {
            width: 400
            height: 300
            color: "#f0f0f0"
            Text {
                text: "Inline QML with QQuickView"
                anchors.centerIn: parent
                font.pixelSize: 24
            }
        }
    )";

    // 创建组件并设置源码
    QQmlComponent component(rootView.engine());
    component.setData(qmlSource.toUtf8(), QUrl()); // 第二个参数为错误提示用的基准URL，可留空

    // 检查组件状态，处理错误
    if (component.status() == QQmlComponent::Error) {
        qWarning() << "QML组件创建错误：" << component.errors();
        return -1;
    }

    // 实例化组件并绑定到QQuickView
    QQuickItem* rootItem = qobject_cast<QQuickItem*>(component.create());
    if (rootItem) {
        rootView.setContent(QUrl(), &component, rootItem);
    }

    rootView.show();
    return qtapp.exec();
}

方法二：使用Data URL直接调用setSource #

将QML源码编码为data scheme的URL，直接传给QQuickView::setSource()，用法和加载本地文件一致：

#include <QGuiApplication>
#include <QQuickView>
#include <QByteArray>

int main(int argc, char *argv[])
{
    QGuiApplication qtapp(argc, argv);
    QQuickView rootView;
    rootView.setResizeMode(QQuickView::SizeRootObjectToView);

    const QString qmlSource = R"(
        import QtQuick 2.15
        Rectangle {
            width: 400
            height: 300
            color: "#e0f7fa"
            Text {
                text: "Data URL QML with QQuickView"
                anchors.centerIn: parent
                font.pixelSize: 24
            }
        }
    )";

    // 将QML源码转换为base64编码的Data URL
    QByteArray encoded = qmlSource.toUtf8().toBase64();
    QUrl dataUrl(QString("data:text/plain;base64,%1").arg(QString::fromUtf8(encoded)));

    rootView.setSource(dataUrl);
    rootView.show();

    return qtapp.exec();
}

两种方法对比 #

• 方法一：更灵活，可在组件创建前后做状态检查、错误处理，适合复杂场景；
• 方法二：代码更简洁，和原有setSource的使用习惯一致，适合简单的inline QML场景。

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