如何从C++端修改QQmlApplicationEngine加载后QML Window的flags属性

问题根源 #

直接操作底层QWindow调用setFlags()的方式不会同步QML侧维护的flags属性状态，QML内部的属性同步逻辑会覆盖对原生窗口的修改，所以改动无法生效。

修正方法 #

不要直接操作底层QWindow的接口，而是通过QObject::setProperty()修改QML对象暴露的flags属性，QML引擎会自动将属性变更同步到底层窗口配置，修改后的main.cpp中回调逻辑如下：

// main.cpp 中objectCreated信号的回调修改为如下逻辑
QObject::connect(
            &engine, &QQmlApplicationEngine::objectCreated, &app,
            [url](QObject *obj, const QUrl &objUrl) {
    if (!obj && url == objUrl) QCoreApplication::exit(-1);
    QVariant flagsVar = obj->property("flags");
    if (flagsVar.isValid()) {
        Qt::WindowFlags flags = qvariant_cast<Qt::WindowFlags>(flagsVar);
        // 移除无边框标志
        flags &= ~Qt::FramelessWindowHint;
        // 直接修改QML对象的flags属性，由QML引擎同步到窗口
        obj->setProperty("flags", QVariant::fromValue(flags));
    }
},
Qt::QueuedConnection);

注意事项 #

• 不需要额外调用show()，QML定义的Window默认创建完成后会自动显示，重复调用无意义还可能引发窗口状态异常
• 不需要做dynamic_cast<QWindow*>类型转换，直接操作QML返回的QObject对象即可，所有属性交互通过Qt元对象系统完成
• 该方案可以在运行时动态修改窗口标志，不需要重新编译QML代码，符合动态修改的需求

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