Fluent-Qt

API リファレンス

FluentElement

QWidget ベースのコンポーネントに、共有の Fluent デザイントークンとテーマコールバックを提供します。

fluent::FluentElement

列挙型

enum Theme

デザイントークン解決時に使用されるグローバルな視覚テーマ。

  • Light = 0
  • Dark = 1
  • HighContrast = 2

メソッド

static void setTheme(Theme theme)

グローバルテーマを更新し、アクティブな FluentElement インスタンスに通知します。

static void setThemeDeferred(Theme theme)

現在の操作をブロックせずに、可視要素を優先したバッチ処理でテーマの更新をスケジュールします。

static Theme currentTheme()

現在有効なグローバルテーマを返します。

static bool themeUsesDarkAppearance(Theme theme)

テーマがダークベースのクロームおよびマテリアルトークンを使用するかどうかを返します。

static void refreshTheme()

デザイントークンの変更後に再描画するため、現在のテーマを再ブロードキャストします。

static int themeGeneration()

テーマ変更ごとに加算される単調増加カウンターです。鮮度チェックに使用されます。

Theme effectiveTheme() const

継承された QWidget の上書きを尊重し、この要素が使用するテーマを解決します。

bool effectiveThemeUsesDarkAppearance() const

この要素の有効なテーマがダークベースのクロームを使用するかどうかを返します。

bool setThemeOverrides(const QJsonObject& overrides)

この要素のスパースな色、角丸半径、フォントトークンの上書きを置き換えます。

QJsonObject themeOverrides() const

この要素に設定されたオーバーライドを返します。

void clearThemeOverrides()

すべてのトークンフィールドをグローバルテーマの既定値に復元します。

const Colors& themeColorsRef() const

描画のホットパス向けにアクティブなカラーセットへ非コピーでアクセスします。

Material::AcrylicToken themeAcrylic() const

マテリアル、エレベーション、およびアダプティブレイアウトのトークン。

QColor themeBackdrop(bool active) const

指定されたアクティブ状態に対するウィンドウ chrome の背景色。

virtual void onThemeUpdated()

グローバルテーマの変更後に呼び出されます。

型とエイリアス

struct Colors

コンポーネントに返されるデザイントークンのスナップショット。

protected メンバー

コンストラクタ

デストラクタ

フィールド

FluentElementPrivate* d_ptr

1.x ソース互換性のために予約されています。

fluent::FluentElement::Colors

コンポーネントに返されるデザイントークンのスナップショット。

フィールド

QColor strokeFocusOuter, strokeFocusInner

フォーカスリングの 2 層ストロークです。

QColor textOnAccent

アクセント背景上のテキスト(白/黒)です。

QColor textAccentPrimary

無地背景上のアクセントテキスト(濃青/淡青)。

QColor systemCritical, systemCriticalBg

システム / セマンティックカラー

QColor bgLayerOverlay

半透明ウィンドウ用のレイヤー化されたコンテンツマスク。

fluent::FluentElement::FontStyle

フィールド

QString styleName

厳密な静的フォントフェイスです(例:"Regular"、"Semibold")。

int lineHeight

Figma から計測した絶対行高(px 単位)。

メソッド

fluent::FluentElement::Radius

フィールド

int none

0: 直角。

int control

4: ページ内コントロール。

int overlay

8: オーバーレイコンテナ(Dialog、ToolTip、Flyout)。

fluent::FluentElement::Spacing

フィールド

controlHeight

標準コントロールの高さ。

fluent::FluentElement::Animation

フィールド