# Label 文本

`AntdUI.Label` 是 AntdUI 的自绘文本控件，相比普通 WinForms Label，提供更好的主题样式、阴影、图标、自动省略、多行等能力。

## 最小示例

```aardio
import win.ui;
import dotNet.AntdUI;
import System.Windows.Forms;
import System.Drawing;

var winform = win.form(text="AntdUI Label";right=520;bottom=220);
winform.add(
    host={cls="custom";left=20;top=20;right=500;bottom=180;dl=1;dt=1;dr=1;db=1;z=1}
);

var label = AntdUI.Label(winform.host);
label.Dock = System.Windows.Forms.DockStyle.Fill;
label.Text = "这是一段 AntdUI.Label 文本，支持多行、自动省略、颜色与图标等常用样式。";
label.TextAlign = System.Drawing.ContentAlignment.MiddleCenter;
label.TextMultiLine = true;
label.AutoEllipsis = true;
label.ForeColor = 0xFF1677FF;

winform.show();
win.loopMessage();
```

## 常用属性

| 属性 | 说明 |
| --- | --- |
| `Text` | 显示文本。 |
| `ForeColor` | 文字颜色；aardio 中直接使用 `0xAARRGGBB` 数值。 |
| `ColorExtend` | 文字渐变色字符串，高级样式可参考上游源码/示例。 |
| `TextAlign` | 文本对齐，使用 `System.Drawing.ContentAlignment`。 |
| `AutoEllipsis` | 文本超出时自动省略。 |
| `TextMultiLine` | 是否允许多行。 |
| `Icon` / `IconSvg` | 图标或 SVG 图标。 |
| `IconRatio` / `IconGap` | 图标比例与图文间距。 |
| `Shadow` / `ShadowColor` | 文本阴影。 |

## 单行省略

```aardio
label.Text = "很长很长的标题文本……";
label.TextMultiLine = false;
label.AutoEllipsis = true;
label.TextAlign = System.Drawing.ContentAlignment.MiddleLeft;
```

## 常见坑

- `ForeColor` 直接使用 `0xAARRGGBB` 数值；不要与普通 GDI `COLORREF` 的 `0xBBGGRR` 混用。
- 如果要响应点击等基础事件，可使用 WinForms 控件通用事件，例如 `Click`。