基础能力

主题与颜色

切换应用主题，并在自绘时读取主题颜色。

切换主题

FluentElement::setTheme() 在 Light、Dark 和 HighContrast 之间切换应用主题，已有的 Fluent 控件会重新绘制。只想修改单个控件的 token 时，向 setThemeOverrides() 传入 JSON 对象；覆盖在切换主题后保留，不作用于子控件。

#include <FluentQt/Foundation.h>

fluent::FluentElement::setTheme(fluent::FluentElement::Dark);

import fluentqt

fluentqt.set_theme(fluentqt.Theme.Dark)

使用主题颜色

按用途读取颜色，例如 textPrimary、bgCanvas，不要写死 RGB 值，这样自绘内容会跟随主题。C++ 绘制代码用 themeColorsRef()；Python 继承 fluentqt.FluentWidget 后用 theme_tokens()。

#include <FluentQt/Foundation.h>

// Inside a FluentElement-based widget's paintEvent()
const auto& colors = themeColorsRef();
const QColor background = colors.bgCanvas;
const QColor text = colors.textPrimary;

import fluentqt

class Swatch(fluentqt.FluentWidget):
    def paintEvent(self, event):
        colors = self.theme_tokens().colors
        background = colors.bgCanvas
        text = colors.textPrimary

切换主题

使用主题颜色

API 参考