# Badge 徽标数

`Badge` 用于显示状态点、数量、提醒数字或短文本，常放在按钮、头像、列表项附近。

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

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

var badge = AntdUI.Badge(winform.host);
badge.Text = "99+";
badge.State = AntdUI.TState.Success;
badge.TextAlign = System.Drawing.ContentAlignment.MiddleCenter;
badge.AutoSize = true;
badge.Dock = System.Windows.Forms.DockStyle.Top;

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

## 常用属性

- `Text`：徽标文本；为空时可配合 `State` / `DotRatio` 做状态点。
- `State`：状态色，常见 `Default`、`Processing`、`Success`、`Error`、`Warn`。
- `Fill` / `ForeColor`：自定义填充色与文字色。
- `DotRatio`：点比例，做红点或状态点时常用。
- `Gap`：徽标与内容之间的间隔。
- `TextAlign`：文字对齐，使用 `System.Drawing.ContentAlignment`。
- `AutoSize`：根据文本自动尺寸。

## 常见用法

- 数量提示：`badge.Text = "12"`。
- 封顶数量：业务层自行把大数转为 `"99+"`。
- 状态点：设置 `State`，并让 `Text` 为空或只显示短文本。

## 注意

- `Badge` 本身是控件；如果要叠加在其他控件右上角，通常需要用 `Panel` 或 WinForms 布局容器组合。