Fluent-Qt

기초 가이드

테마와 색상

라이트, 다크 또는 고대비 테마를 전환하고 커스텀 페인트 코드에서 테마 색상을 읽습니다.

테마 전환

FluentElement::setTheme()는 Light, Dark, HighContrast 간 전환을 수행하고 모든 컨트롤을 자동으로 다시 그립니다. 단일 위젯의 색상이나 크기만 바꾸려면 JSON 객체를 setThemeOverrides()에 전달하세요. 해당 재정의는 테마 전환 후에도 유지됩니다.

#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 레퍼런스