# Tag 标签

`Tag` 用于标记、分类、状态显示，支持预设类型、关闭图标、图片/SVG 图标与自定义颜色。

```aardio
import win.ui;
var winform = win.form(text="AntdUI Tag";right=520;bottom=240)
winform.add(host={cls="custom";left=20;top=20;right=490;bottom=200;z=1})

import dotNet.AntdUI;
import System.Windows.Forms;

var tag = AntdUI.Tag(winform.host);
tag.Text = "Primary";
tag.Type = AntdUI.TTypeMini.Primary;
tag.CloseIcon = true;
tag.AutoSize = true;
tag.Dock = System.Windows.Forms.DockStyle.Top;

tag.CloseChanged = function(sender,e){
    winform.text = "点击了关闭图标";
    return true;
}

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

## 常用属性

- `Text`：标签文本。
- `Type`：标签类型，常见 `Default`、`Primary`、`Success`、`Error`、`Warn`、`Info`。
- `CloseIcon`：显示关闭图标。
- `ForeColor` / `BackColor`：自定义前景色与背景色。
- `BorderWidth`：边框宽度。
- `Radius`：圆角。
- `TextAlign`：文本对齐。
- `AutoEllipsis`：文本超出省略。
- `TextMultiLine`：允许多行文本。
- `Image` / `ImageSvg` / `ImageSize`：标签图标。
- `AutoSize` / `AutoSizeMode`：自动尺寸。

## 事件

- `CloseChanged`：点击关闭图标时触发，返回布尔值用于控制关闭逻辑。若只是作为提示标签，可以忽略此事件。

## 注意

- `Tag` 是单个标签控件；标签组可用 WinForms `FlowLayoutPanel` 或 AntdUI `FlowPanel` 承载多个 `Tag`。
- `CloseIcon=true` 只显示关闭入口，业务层仍需在事件中决定是否移除控件或隐藏控件。