Fluent-Qt

基礎ガイド

テーマとカラー

ライト・ダーク・ハイコントラストテーマを切り替え、カスタム描画コードからテーマカラーを取得します。

テーマの切り替え

FluentElement::setTheme() で Light・Dark・HighContrast を切り替えると、すべてのコントロールが自動的に再描画されます。単一のウィジェットだけ色やサイズを調整したい場合は setThemeOverrides() に JSON オブジェクトを渡してください。この上書き設定はテーマ切り替え後も維持されます。

#include <FluentQt/Foundation.h>

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

テーマカラーの取得

ハードコードした RGB 値の代わりに bgCanvas や textPrimary などの名前付きカラーを使うことで、カスタム描画もテーマ切り替えに追従します。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;

API リファレンス