为何通过C++创建QML对象后应用界面无任何显示？

1. 实例未加入可视化渲染树 #

你通过component.create()创建的QQuickItem实例仅存在于内存中，没有被添加到任何已显示的QQuickWindow或QQuickView的根节点下，因此不会被渲染到屏幕上。

2. 属性设置错误 #

SingleTile.qml的根节点是Item，它本身没有color属性，你调用object->setProperty("color", "blue")是在修改一个不存在的属性；而QML里的Rectangle的color是它自身的独立属性，和根Item无关。

3. QML本身的隐藏问题 #

原QML中的Rectangle没有设置width和height，默认尺寸是0x0，就算能显示也看不到任何内容。

修复后的代码示例 #

调整SingleTile.qml（添加Rectangle的尺寸和id） #

import QtQuick 2.15

Item {
    width: 100; height: 100

    Rectangle {
        id: tileRect // 给Rectangle加id，方便C++端定位
        anchors.centerIn: parent
        color: "green"
        width: parent.width // 绑定父节点宽高，确保可见
        height: parent.height
    }
}

修改C++代码（将实例加入渲染树并正确修改属性） #

假设你已有一个初始化好的QQuickView窗口：

QQuickView view;
view.setSource(QUrl("qrc:/main.qml")); // 主窗口的QML文件路径
view.show();

QQmlEngine* engine = view.engine();
QQmlComponent component(engine, QUrl::fromLocalFile("SingleTile.qml"));
QQuickItem* object = qobject_cast<QQuickItem*>(component.create());

if (object) {
    // 将创建的Item添加到窗口的根节点下，加入渲染树
    object->setParentItem(view.rootObject());
    // 查找Rectangle子节点并修改颜色
    QQuickItem* tileRect = object->findChild<QQuickItem*>("tileRect");
    if (tileRect) {
        tileRect->setProperty("color", "blue");
    }
}

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