Carousel 走马灯

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

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。

Markdown 格式