AntdUI分段控制器：Segmented的分段选择与样式定制

还在为WinForm应用中的分段选择控件而烦恼吗？AntdUI的Segmented分段控制器为你提供了一套完整、美观且高度可定制的解决方案。本文将深入解析Segmented控件的核心功能、样式定制技巧以及实际应用场景，帮助你快速掌握这一强大的UI组件。

什么是Segmented分段控制器？

Segmented是AntdUI基于Ant Design设计语言开发的一款WinForm分段选择控件。它允许用户在一组相关的选项中进行快速切换，是现代应用中常见的交互模式，特别适用于：

• 时间范围选择（日/周/月/季度/年）
• 视图模式切换（列表/网格/卡片）
• 主题切换（亮色/暗色）
• 数据筛选（全部/进行中/已完成）
• 分类导航（热门/最新/推荐）

核心功能特性

基础分段选择

Segmented控件最基础的功能就是提供多个选项供用户选择：

// 创建Segmented控件
var segmented = new AntdUI.Segmented();

// 添加选项项
segmented.Items.Add(new SegmentedItem { Text = "日视图" });
segmented.Items.Add(new SegmentedItem { Text = "周视图" });
segmented.Items.Add(new SegmentedItem { Text = "月视图" });
segmented.Items.Add(new SegmentedItem { Text = "季度视图" });

// 设置默认选中项
segmented.SelectIndex = 0;

// 监听选择变化事件
segmented.SelectIndexChanged += (sender, e) => 
{
    Console.WriteLine($"选中了第{e.Value}个选项");
};

图标与文字组合

Segmented支持丰富的图标展示，可以配置不同状态下的图标：

var segmentedItem = new SegmentedItem
{
    Text = "收藏",
    IconSvg = "LikeFilled",           // 默认状态图标
    IconActiveSvg = "HeartFilled",    // 激活状态图标
    IconHoverSvg = "LikeOutlined"     // 悬停状态图标
};

徽标(Badge)功能

每个选项项都可以添加徽标，用于显示通知数量或状态标识：

var segmentedItem = new SegmentedItem
{
    Text = "消息",
    Badge = "99+",                    // 徽标文本
    BadgeAlign = TAlign.TR,           // 徽标位置（右上角）
    BadgeSize = 0.6F,                 // 徽标大小比例
    BadgeBack = Color.Red             // 徽标背景色
};

样式定制详解

布局方向控制

Segmented支持水平和垂直两种布局方向：

属性	类型	默认值	描述
Vertical	bool	false	是否竖向排列
Full	bool	false	是否铺满容器
Gap	int	0	选项间距

// 垂直布局示例
segmented.Vertical = true;
segmented.Full = true;  // 铺满容器

圆角与形状样式

// 设置圆角
segmented.Radius = 8;    // 圆角大小
segmented.Round = true;  // 圆形样式

// 条状指示器样式
segmented.BarPosition = TAlignMini.Bottom;  // 底部指示条
segmented.BarSize = 3F;                     // 指示条粗细
segmented.BarRadius = 2;                    // 指示条圆角

颜色主题定制

Segmented提供了完整的颜色定制能力：

// 文字颜色定制
segmented.ForeColor = Color.Black;          // 默认文字颜色
segmented.ForeHover = Color.Blue;           // 悬停文字颜色  
segmented.ForeActive = Color.Red;           // 激活文字颜色

// 背景颜色定制
segmented.BackColor = Color.LightGray;      // 默认背景颜色
segmented.BackHover = Color.LightBlue;      // 悬停背景颜色
segmented.BackActive = Color.LightGreen;    // 激活背景颜色

// 指示条颜色
segmented.BarColor = Color.Orange;          // 指示条颜色

图标布局配置

// 图标对齐方式
segmented.IconAlign = TAlignMini.Left;  // 图标在文字左侧

// 图标大小比例
segmented.IconRatio = 0.8F;             // 图标大小为文字的80%

// 图标与文字间距
segmented.IconGap = 0.3F;               // 间距为文字高度的30%

实际应用场景

时间范围选择器

var timeRangeSegmented = new AntdUI.Segmented
{
    IconAlign = TAlignMini.Left,
    Radius = 6,
    BarPosition = TAlignMini.Bottom
};

timeRangeSegmented.Items.AddRange(new[]
{
    new SegmentedItem { Text = "日", IconSvg = "CalendarOutlined" },
    new SegmentedItem { Text = "周", IconSvg = "CalendarFilled" },
    new SegmentedItem { Text = "月", IconSvg = "CalendarTwoTone" },
    new SegmentedItem { Text = "季度", IconSvg = "DashboardFilled" },
    new SegmentedItem { Text = "年", IconSvg = "CrownFilled" }
});

timeRangeSegmented.SelectIndex = 2;  // 默认选中"月"

主题切换器

var themeSegmented = new AntdUI.Segmented
{
    Round = true,
    IconRatio = 0.8F
};

themeSegmented.Items.AddRange(new[]
{
    new SegmentedItem 
    { 
        IconSvg = "SunOutlined", 
        IconActiveSvg = "SunFilled",
        Text = "亮色模式"
    },
    new SegmentedItem 
    { 
        IconSvg = "MoonOutlined",
        IconActiveSvg = "MoonFilled", 
        Text = "暗色模式"
    }
});

带徽标的消息分类

var messageSegmented = new AntdUI.Segmented();

messageSegmented.Items.AddRange(new[]
{
    new SegmentedItem 
    { 
        Text = "全部", 
        Badge = "128",
        BadgeBack = Color.FromArgb(255, 87, 107, 149)
    },
    new SegmentedItem 
    { 
        Text = "未读", 
        Badge = "12",
        BadgeBack = Color.Red
    },
    new SegmentedItem 
    { 
        Text = "已读", 
        Badge = "116",
        BadgeBack = Color.Green
    }
});

高级功能与技巧

动画效果

Segmented内置了平滑的切换动画效果：

// 启用动画（默认已启用）
// 可以通过Config.HasAnimation("Segmented")控制

// 自定义动画速度
segmented.SelectIndex = 2;  // 带有动画的切换

国际化支持

var segmentedItem = new SegmentedItem
{
    Text = "Daily",  // 默认文本
    LocalizationText = "Segmented.Daily"  // 国际化键名
};

禁用状态管理

// 禁用单个选项
var disabledItem = new SegmentedItem
{
    Text = "禁用选项",
    Enabled = false  // 禁用此项
};

// 整个控件禁用
segmented.Enabled = false;

性能优化建议

1. 批量操作：使用Items.AddRange()批量添加选项项
2. 布局暂停：大量操作时使用PauseLayout = true暂停布局计算
3. 资源管理：及时释放不再使用的图标资源
4. 动画控制：在性能敏感场景下考虑禁用动画

总结

AntdUI的Segmented分段控制器是一个功能强大、样式美观且高度可定制的WinForm组件。通过本文的详细解析，你应该已经掌握了：

• ✅ Segmented的基本用法和核心功能
• ✅ 丰富的样式定制选项（颜色、圆角、图标等）
• ✅ 实际应用场景的最佳实践
• ✅ 高级功能和性能优化技巧

无论你是需要简单的时间选择器，还是复杂的主题切换功能，Segmented都能提供优雅的解决方案。其遵循Ant Design设计语言，确保与整个AntdUI生态系统完美融合，为你的WinForm应用带来现代化的用户体验。

现在就开始使用Segmented，为你的应用添加专业级的分段选择功能吧！