Qt5.15 LTS中自定义Window动态切换Fusion样式主题

我正在使用Qt 5.15 LTS开发基于Fusion样式的QML应用，需要实现运行时切换亮色、暗色等主题的功能。官方文档显示，修改QML中的palette对象可更改Fusion样式的配色系统，该操作在ApplicationWindow中易于实现，但我必须使用自定义Window对象。我尝试通过以下C++代码修改全局调色板：

// @theme_dark_ and @theme_light_ are pre-defined palette object.
Q_INVOKABLE void Backend::SetDarkMode(const bool flag) {
  qGuiApp->setPalette(flag ? theme_dark_ : theme_light_);
}

发现QML应用启动前调用setPalette有效，但运行时调用无效。请问是否有办法在QML的Window类型中修改palette，或让QML运行时调用QCoreApplication::setPalette生效？

方法一：在QML自定义Window中直接修改palette #

QML的Window类型本身支持palette属性，可直接在QML层面绑定或动态修改，无需依赖C++全局设置：

1. 先在C++中将预定义的亮色/暗色调色板注册为QML可访问的属性，并添加主题切换的信号通知：

class Backend : public QObject
{
    Q_OBJECT
    Q_PROPERTY(QPalette lightPalette READ lightPalette CONSTANT)
    Q_PROPERTY(QPalette darkPalette READ darkPalette CONSTANT)
    Q_PROPERTY(bool isDarkMode READ isDarkMode NOTIFY isDarkModeChanged)
private:
    bool m_isDarkMode = false;
    QPalette theme_light_;
    QPalette theme_dark_;
public:
    Q_INVOKABLE void SetDarkMode(bool flag) {
        m_isDarkMode = flag;
        emit isDarkModeChanged(flag);
    }

    QPalette lightPalette() const { return theme_light_; }
    QPalette darkPalette() const { return theme_dark_; }
    bool isDarkMode() const { return m_isDarkMode; }

signals:
    void isDarkModeChanged(bool isDark);
};

2. 在QML的自定义Window中通过属性绑定实时更新palette：

Window {
    id: customWindow
    visible: true
    width: 640
    height: 480
    title: qsTr("Custom Window Theme Demo")

    // 直接绑定Backend的主题状态与对应调色板
    palette: backend.isDarkMode ? backend.darkPalette : backend.lightPalette
}

这种方式符合QML开发范式，属性绑定会自动同步UI，运行时切换主题立即生效。

方法二：让C++全局setPalette在运行时生效 #

启动前调用有效但运行时无效，是因为QML Window初始化时会缓存全局palette，后续全局变更不会自动同步。解决方法是设置全局palette后，手动更新所有QML窗口的palette：

Q_INVOKABLE void Backend::SetDarkMode(bool flag) {
    QPalette targetPalette = flag ? theme_dark_ : theme_light_;
    qGuiApp->setPalette(targetPalette);

    // 遍历所有顶层QML窗口，强制更新palette并刷新UI
    for (QWindow* window : qGuiApp->topLevelWindows()) {
        if (QQuickWindow* quickWindow = qobject_cast<QQuickWindow*>(window)) {
            quickWindow->setPalette(targetPalette);
            quickWindow->update();
        }
    }
}

该方法直接更新每个QML窗口的缓存palette，确保全局设置的变更能实时反映到UI上。

注意事项 #

• 确保自定义Window底层继承自QQuickWindow（QML的Window默认基于该类），否则上述方法可能不适用。
• 优先选择方法一的QML属性绑定方式，避免手动遍历窗口的复杂性，也更贴合QML的响应式设计理念。
• Qt 5.15 LTS中，Fusion样式的子控件会自动继承Window的palette，修改Window的palette会同步到所有子控件。

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