# Segmented 分段控制器

`Segmented` 用于在少量选项之间快速切换，常见于视图模式、状态筛选、时间范围切换等场景。

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

import dotNet.AntdUI;

var seg = AntdUI.Segmented(winform.host);
seg.Full = true;
seg.Round = true;
seg.Items.Add(AntdUI.SegmentedItem().SetText("day","今日"));
seg.Items.Add(AntdUI.SegmentedItem().SetText("week","本周").SetBadge("3",AntdUI.TAlign.TR));
seg.Items.Add(AntdUI.SegmentedItem().SetText("month","本月"));
seg.SelectIndex = 0;
seg.Dock = System.Windows.Forms.DockStyle.Top;

seg.SelectIndexChanged = function(sender,index){
    winform.text = "当前选项：" + index;
}

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

## 常用属性

- `Items`：选项集合，添加 `AntdUI.SegmentedItem`。
- `SelectIndex`：当前选中项，0 基索引。
- `Full`：是否铺满宽度。
- `Vertical`：垂直布局。
- `Round` / `Radius`：圆角。
- `Gap` / `ItemGap`：整体与单项间距。
- `IconAlign` / `IconRatio` / `IconGap`：图标布局。
- `BackColor` / `BackHover` / `BackActive`：背景色。
- `ForeColor` / `ForeHover` / `ForeActive`：文字色。
- `BarPosition` / `BarSize` / `BarColor`：下划线/指示条样式。

## SegmentedItem

- `ID`：业务标识。
- `Text`：显示文本。
- `IconSvg` / `IconActiveSvg` / `IconHoverSvg`：图标。
- `Enabled`：是否可用。
- `Badge` / `BadgeSvg`：角标。
- `Tooltip`：提示文本。
- 链式方法：`SetText(id,text)`、`SetIcon(svg)`、`SetEnabled(bool)`、`SetBadge(text,align)`。

## 事件

- `SelectIndexChanged(index)`：选中序号改变。
- `SelectIndexChanging(index, cancel)`：选中前触发。
- `ItemClick(e,item)`：点击项。

## 注意

- `SelectIndex` 从 0 开始。
- 分段项数量不宜过多；超过 5~7 个时通常改用 `Tabs`、`Select` 或 `Menu` 更合适。