# Carousel 走马灯

`Carousel` 用于轮播一组图片或宣传图，支持自动播放、手势滑动、指示点位置与图片填充方式。

```aardio
import win.ui;
var winform = win.form(text="AntdUI Carousel";right=760;bottom=420)
winform.add(host={cls="custom";left=20;top=20;right=730;bottom=360;z=1})

import dotNet.AntdUI;
import System.Drawing;

var carousel = AntdUI.Carousel(winform.host);
carousel.Autoplay = true;
carousel.Autodelay = 3;
carousel.ImageFit = AntdUI.TFit.Cover;
carousel.Radius = 8;
carousel.Dock = System.Windows.Forms.DockStyle.Fill;

// 实际项目中通常使用 System.Drawing.Image.FromFile(path) 加载图片。
var item1 = AntdUI.CarouselItem();
item1.ID = "first";
item1.Tag = "业务数据";
carousel.Image.Add(item1);

carousel.SelectIndexChanged = function(sender,index){
    winform.text = "当前轮播序号：" + index;
}

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

## 常用属性

- `Image`：图片集合，添加 `AntdUI.CarouselItem`。
- `ImageFit`：图片布局，常用 `AntdUI.TFit.Cover`。
- `SelectIndex`：当前选中项，0 基索引。
- `Autoplay` / `Autodelay`：自动播放与延迟秒数。
- `Touch` / `TouchOut`：手势滑动。
- `DotSize` / `DotMargin` / `DotPosition` / `DotFocusedColor`：指示点样式。
- `Radius` / `Round`：圆角。

## CarouselItem

- `ID`：业务标识。
- `Img`：`System.Drawing.Image` 图片。
- `Tag`：用户自定义数据。
- `SetImage(image)` / `SetID(id)` / `SetTag(value)`：链式设置。

## 注意

- 文档示例只演示集合用法，没有加载真实图片；真实使用请为每个 `CarouselItem.Img` 指定 `System.Drawing.Image`。
- 图片轮播控件建议设置明确尺寸或 `Dock=Fill`。