# 主题、颜色与 DPI

AntdUI 支持浅色/深色主题、动画与高 DPI。全局配置通常在程序启动后尽早设置。普通应用可以先使用默认主题，等界面结构稳定后再统一调整颜色。

## 颜色

AntdUI 颜色属性在 .NET 中是 `System.Drawing.Color` 或可空 `Color`，但在 aardio 中 `System.Drawing.Color` 就是 `0xAARRGGBB` 格式数值；将这种数值传给 .NET 颜色属性时也会自动转换。因此直接写 ARGB 数值即可，不需要调用 `System.Drawing.Color.FromArgb(...)`。

```aardio
import dotNet.AntdUI;

var btn = AntdUI.Button(winform.host);
btn.Text = "颜色";
btn.BackColor = 0xFF1677FF;
btn.ForeColor = 0xFFFFFFFF;
```

## 颜色格式

`0xAARRGGBB` 从高位到低位依次表示透明度、红、绿、蓝，与 GDI+、gdip 库和 plus 控件的运行时颜色格式相同：

```aardio
var primary = 0xFF1677FF;
var success = 0xFF52C41A;
var warn = 0xFFFAAD14;
var translucentPrimary = 0x781677FF; // 透明度 A=0x78
```

不要与普通 GDI 控件创建参数常用的 `0xBBGGRR`（COLORREF）混用。

## DPI 与尺寸

AntdUI 控件自身处理 DPI；aardio `winform.add` 中的位置尺寸仍按 aardio 窗口设计规则处理。建议优先使用 `custom` 控件固定边距实现自适应布局。

```aardio
winform.add(host={cls="custom";left=20;top=20;right=620;bottom=420;dl=1;dt=1;dr=1;db=1;z=1});
```

## 建议

- 普通应用先使用默认主题。
- 统一主题色时再集中设置全局 `Config` / `Style`。
- 文档示例以清晰为主，复杂主题定制请参考上游 AntdUI wiki。
- 多控件页面优先使用 AntdUI 布局容器，减少手动计算位置。