테마
이 문서는 MewUI의 테마(Theme) 시스템을 설명합니다.
1. 테마 구성 요소
섹션 제목: “1. 테마 구성 요소”MewUI의 Theme는 아래 4가지 입력으로 결정됩니다.
ThemeVariant:System/Light/DarkAccent또는Color: 강조색(Accent)ThemeSeed: 라이트/다크 베이스 팔레트 시드ThemeMetrics: 컨트롤 크기/패딩/두께/폰트 등 “룩앤필” 메트릭
아래 예제들은 모두 Run 전에 값을 지정하는 “기본값(Defaults)” 용도입니다.
1.1 ThemeVariant
섹션 제목: “1.1 ThemeVariant”포함하는 요소: “라이트/다크 모드” 또는 “OS 설정(System) 추종”을 선택합니다.
using Aprillz.MewUI;
// Default는 기본값이 ThemeVariant.System 이므로,// System을 그대로 쓸 거라면 이 설정은 생략해도 동작이 동일합니다.ThemeManager.Default = ThemeVariant.System;// ThemeManager.Default = ThemeVariant.Light;// ThemeManager.Default = ThemeVariant.Dark;1.2 Accent
섹션 제목: “1.2 Accent”포함하는 요소: 기본 제공 Accent(Accent.*) 또는 사용자 지정 Color로 “강조색”을 지정합니다.
using Aprillz.MewUI;
ThemeManager.DefaultAccent = Accent.Blue;참고: Custom Color는 보통 런타임 변경에서 많이 사용합니다(3.2 참고).
1.3 ThemeSeed
섹션 제목: “1.3 ThemeSeed”포함하는 요소: Light/Dark 각각의 “베이스 팔레트 시드”를 지정합니다. (기본 룩을 결정)
ThemeSeed에 포함되는 대표 속성:
WindowBackground: 윈도우 배경WindowText: 윈도우 기본 텍스트 색ControlBackground: 컨트롤 배경ButtonFace: 버튼 기본 배경ButtonDisabledBackground: 비활성 버튼 배경
using Aprillz.MewUI;
ThemeManager.DefaultLightSeed = ThemeSeed.DefaultLight;ThemeManager.DefaultDarkSeed = ThemeSeed.DefaultDark;1.4 ThemeMetrics
섹션 제목: “1.4 ThemeMetrics”포함하는 요소: 앱 전체의 “기본 폰트/크기” 및 컨트롤 기본 높이/패딩/스크롤바 두께 등 UI 메트릭을 지정합니다.
ThemeMetrics에 포함되는 대표 속성:
FontFamily,FontSize,FontWeightBaseControlHeightControlCornerRadiusItemPaddingScrollBarThickness,ScrollBarHitThickness,ScrollBarMinThumbLengthScrollWheelStep,ScrollBarSmallChange,ScrollBarLargeChange
using Aprillz.MewUI;
ThemeManager.DefaultMetrics = ThemeMetrics.Default with{ ControlCornerRadius = 6, FontSize = 13, FontFamily = "Noto Sans"};기본 폰트와 시스템 폰트
섹션 제목: “기본 폰트와 시스템 폰트”FontFamily를 지정하지 않으면 플랫폼의 시스템 UI 폰트를 따릅니다. Windows는 시스템 설정의 UI 폰트(한국어 환경은 맑은 고딕), macOS는 .AppleSystemUIFont, X11은 sans-serif입니다. 이 상태를 명시적으로 쓰려면 ThemeMetrics.SystemFontFamily를 대입하고, 현재 시스템 폰트를 따르는 중인지는 IsSystemFontFamily로 확인합니다.
폰트명을 지정하면 시스템 폰트 대신 그 폰트가 그대로 쓰입니다. "Segoe UI"처럼 특정 플랫폼의 시스템 폰트와 같은 이름을 지정해도 마찬가지입니다.
// 시스템 폰트 대신 Segoe UI 고정ThemeManager.DefaultMetrics = ThemeMetrics.Default with { FontFamily = "Segoe UI" };
// 폰트는 시스템 폰트를 따르고 크기만 조정ThemeManager.DefaultMetrics = ThemeMetrics.Default with { FontSize = 13 };FontFamily가 읽는 시점에 해석되므로, 플랫폼 패키지 등록(Win32Platform.Register() 등) 이후라면 언제 읽어도 실제 적용될 폰트명을 얻습니다. ThemeMetrics.Default.FontFamily는 시스템 폰트를, ThemeManager.DefaultMetrics.FontFamily는 사용자 지정까지 반영한 최종 폰트를 돌려줍니다.
한글 등 지정한 폰트에 없는 글자는 폰트 폴백 체인이 처리하므로, Segoe UI를 지정해도 한글은 정상적으로 표시됩니다.
2. 시작 시 테마 설정
섹션 제목: “2. 시작 시 테마 설정”권장 순서:
ThemeManager.Default*먼저 고정- UI 빌드
Application.Run(...)
2.1 ThemeSeed 사용자 지정 예제
섹션 제목: “2.1 ThemeSeed 사용자 지정 예제”using Aprillz.MewUI;
// 기본값(Default)을 전부 다시 지정할 필요는 없습니다.// 바꾸고 싶은 것만 선택적으로 설정하세요.
ThemeManager.DefaultLightSeed = ThemeSeed.DefaultLight with{ WindowText = Color.FromRgb(20, 20, 20)};
ThemeManager.DefaultDarkSeed = ThemeSeed.DefaultDark with{ WindowText = Color.FromRgb(240, 240, 240)};
var mainWindow = new Window() .Title("Theme Seed Demo") .Content(new TextBlock().Text("Hello, MewUI").Bold());
Application.Run(mainWindow);2.2 ApplicationBuilder로 설정 적용
섹션 제목: “2.2 ApplicationBuilder로 설정 적용”포함하는 요소:
- Builder의
UseTheme/UseAccent/UseSeed/UseMetrics로 테마 입력을 설정 - (선택) 플랫폼/백엔드 패키지의
UseWin32/UseDirect2D등으로 등록/선택까지 체인으로 연결
참고:
- Builder는 내부적으로
ThemeManager.Default*를 Run 직전에 반영합니다.
using Aprillz.MewUI;
var mainWindow = new Window() .Title("Theme + Builder") .Content(new TextBlock().Text("Hello"));
Application.Create() .UseMetrics(ThemeMetrics.Default with { ControlCornerRadius = 6, FontSize = 13, FontFamily = "Noto Sans" }) .UseSeed( ThemeSeed.DefaultLight with { WindowText = Color.FromRgb(20, 20, 20) }, ThemeSeed.DefaultDark with { WindowText = Color.FromRgb(240, 240, 240) }) // 필요하면 아래처럼 모드/액센트도 설정 (System/Blue는 기본값이라 생략 가능) // .UseTheme(ThemeVariant.System) // .UseAccent(Accent.Blue) .UseWin32() .UseDirect2D() .Run(mainWindow);3. 실행 중 테마 변경
섹션 제목: “3. 실행 중 테마 변경”일반적으로 런타임에서 즉시 적용/전파되는 변경은 아래 2개를 지원합니다.
3.1 ThemeVariant 변경
섹션 제목: “3.1 ThemeVariant 변경”Application.Current.SetTheme(ThemeVariant.Dark);// Application.Current.SetTheme(ThemeVariant.Light);// Application.Current.SetTheme(ThemeVariant.System);3.2 Accent 변경
섹션 제목: “3.2 Accent 변경”Application.Current.SetAccent(Accent.Green);
// Custom colorApplication.Current.SetAccent(new Color(0xFF, 0x22, 0x88, 0xFF));4. 테마 변경 콜백
섹션 제목: “4. 테마 변경 콜백”테마가 바뀔 때마다(사용자 전환, System 모드에서 OS 테마 변경 등) 특정 속성을 현재 테마 기준으로 다시 적용하고 싶다면,
WithTheme((theme, control) => ...) 패턴을 사용합니다.
var accentButton = new Button() .Text("Accent Button") .WithTheme((theme, c) => { c.Background(theme.Palette.Accent); c.Foreground(theme.Palette.AccentText); });5. 테마 변경 이벤트
섹션 제목: “5. 테마 변경 이벤트”Application.Current.ThemeChanged += (oldTheme, newTheme) =>{ // 로깅/설정 저장/통계 등};