控件开发了一段时间，花费了不少精力开发与测试，无法全部一一更新，示例图如下，不分先后顺序，没有分类。还要花费时间进行各种测试，如有时间会一一补充。
参考了 Ant Design、LayUI，DotNetBar2及多款开源的UI项目

一、先睹为快

layout布局有7种功能非常多

二、介绍（可能会有更新无法及时同步，敬请关注）

AntdUIEx 控件库文档

文档索引

本目录包含 AntdUIEx 控件库的所有控件文档。

布局与容器

控件名称	中文名称	说明
PanelEx	增强面板控件	支持圆角、光晕阴影、箭头指向、内部拖放、鼠标悬停效果、双重边距控制、主题适配
CourseSchedule	课程表/培训表控件	支持自定义标题、网格线、星期显示（中/英文）、时间段控制、课程数据绑定、主题适配
StartScreen	开始屏幕控件	支持分组管理、拖拽排序、悬停效果、滚动条、SVG图标、分组名称编辑、状态持久化
LayoutEx	布局控件(Frames)	支持7种经典布局模式、圆角边框、自定义内边距、Ant Design主题
FlexLayout	Flex弹性布局控件	参考Ant Design Flex设计，支持方向、对齐、间距、换行等设置
Masonry	瀑布流布局控件	参考Ant Design Masonry设计，用于展示不同高度的内容，按列均匀分布
SplitterEx	增强分割容器控件	支持折叠/展开、圆角按钮、智能比例保持、双击切换
NavigationMenuEx	导航菜单控件	横向/纵向布局、图标+文字多种组合、子菜单、圆角边框、分割线/间隙、层级颜色、宽度自适应
MenuStripEx	增强菜单控件	多级菜单、图标、快捷键、ToolTip、对齐方式、分割线、主题适配、DesignTime支持
Collapse	折叠面板控件	参考Ant Design Collapse设计，支持面板展开/折叠、手风琴模式、平滑动画、主题支持、FillRemaining铺满剩余空间、文本/控件内容
Table	表格控件	支持多种数据类型（文本、数字、布尔、图片、标签、进度条、链接、图标、图标+文本）、表头固定、复选框选择、斑马纹、排序、列宽调整、主题支持、滚动条悬停显示、自定义滚动条颜色、INotifyPropertyChanged 属性变更通知
TableLayoutPanelEx	增强表格布局面板	支持行列精确控制、单元格合并（RowSpan/ColumnSpan）、表头行/列、控件拉伸与对齐、网格线显示、设计时扩展属性（行号/列号/合并/拉伸/对齐）、表格在控件内9种对齐方式、独立边框与网格线设置

加载与反馈

控件名称	中文名称	说明
SpinEx	加载动画控件	支持多种动画类型、半透明遮罩、SVG图标、点击关闭、Layered Window技术
WaitingBar	等待进度条控件	滑块左右来回移动、平滑缓动动画、圆角样式、多种颜色主题、不阻塞线程
TrackBar	滑动条控件	支持横向/纵向、刻度显示、圆角样式、倒序排列、主题适配

基础控件

控件名称	中文名称	说明
ButtonEx	按钮控件	支持多种形状、颜色类型、SVG图标（Ant Design 功能色）
FloatButtonEx	悬浮按钮控件	支持多个按钮排列、SVG图标、徽标、加载状态
LabelEx	标签控件	支持横向/纵向布局、超链接、旋转、跑马灯
LabelText	标签值控件	无缝双部分设计、左侧标签+右侧值、SVG图标、圆角可调
Alert	警告提示控件	参考Ant Design Alert、四种类型(Success/Info/Warning/Error)、可关闭、图标显示、标题描述支持换行
InputBox	输入框控件	支持前缀后缀图标、占位符、清除按钮、边框样式
NumberBox	数字输入框控件	支持增减按钮、精度控制、范围限制
ComboBoxEx	下拉框控件	支持多种样式、圆角边框、自定义颜色
DropdownInput	下拉输入框控件	支持自动完成、搜索筛选、多种匹配模式、主题适配
ButtonSpinner	按钮旋转选择器控件	支持上下按钮切换选项、文本对齐、前缀后缀、水印、禁用状态
ListBoxEx	增强型列表框控件	支持图标、自定义颜色、禁用项、提示文本、滚动条
CheckBoxEx	复选框控件	支持多种样式、自定义颜色、圆角设置、半选状态
CheckBoxGroup	复选框组控件	支持多项选择、全选/半选功能、灵活布局
RadioEx	单选按钮控件	支持多种样式、分组管理、互斥选择
RadioGroup	单选框组控件	批量管理单选框、横向/纵向布局、快速取值、选项数据绑定、设计时设置默认值、顺序稳定
SwitchEx	开关控件	支持多种样式、形状、颜色自定义
ThemeToggleButton	主题切换按钮	支持亮/暗主题切换、Ant Design 功能色主题类型(Primary/Success/Warning/Error/Info)、滑块颜色自定义、属性变更通知
RichtextboxEx	增强型富文本框控件	支持行号、圆角边框、徽标显示
DateTimePicker	日期时间选择器控件	支持年份/月份/日期/时间四种模式、主题色、文本框绑定
TaskDialog	任务对话框控件	现代化对话框、图标支持、圆角边框、遮罩层、主题适配、可拖动
InputDialog	输入对话框控件	文本/密码/数字/单选/多选/颜色输入、使用InputBox/RadioEx/CheckBoxEx/ColorPicker控件、水印提示、遮罩层、主题适配、自定义主题色
Popconfirm	气泡确认框控件	轻量交互、12个弹出方向、箭头指向、SVG图标、异步关闭、透明度设置
PopConfirmShadow	带阴影气泡确认框控件	Layered Window技术、真实半透明阴影、阴影包含箭头、4个弹出方向、SVG图标、异步关闭
MessageBoxEx	消息框控件	非模态悬浮消息提示，支持四种类型、七种位置、自动关闭
MessageTip	迷你消失提示框	在触发控件上方弹出，向上移动后淡出消失，支持四种消息类型
MessagePanel	消息面板控件	全部/未读筛选、已读红点标记、删除确认、鼠标滚轮滚动、悬停效果、Tooltip提示、主题适配
TrafficLight	红绿灯控件	支持垂直/水平布局、常亮/闪烁状态、光晕效果、标签显示、主题适配
StatusStrip	状态栏控件	底部停靠、支持9种子控件类型（LabelTimeEx/ProgressBar/ButtonEx/Signal/Battery/TrackBar/WaitingBar/SwitchEx/LabelEx）、Spring布局、设计时拖放限制、建议在PanelItems集合编辑器中调整顺序（不建议拖拽排序）、集合编辑器添加按钮会添加未知类型控件请不要使用

窗体与容器

控件名称	中文名称	说明
UIForm	自定义窗体基类	无边框窗体、自定义标题栏、阴影效果、圆角边框、亮暗主题切换、子控件递归主题传递
UIFormSizable	可调尺寸窗体基类	继承自 UIForm，支持运行时拖拽调整窗体大小，注意：存在圆角边框视觉瑕疵和主题色同步问题
DrawerEx	抽屉组件	四方向滑入面板、窗体/控件级显示、支持任意内容载体、可配置按钮位置、系统级关闭按钮样式、平滑动画、可拖拽调整大小
GroupBox	分组框控件	支持多种标题位置、折叠功能、闪烁提示
ExplorerBar	资源管理器栏控件	支持分组管理、展开/折叠、图标显示
Transfer	穿梭框控件	支持双向数据穿梭、搜索过滤、双击转移
Grid4	四宫格控件	2x2网格布局，支持图标、文本、徽章
Grid9	九宫格控件	3x3网格布局，支持图标、文本、徽章
Grid16	十六宫格控件	4x4网格布局，支持图标、文本、徽章
Grid32	三十二宫格控件	8×4或4×8网格布局，支持图标、文本、徽章、独立文本颜色、布局切换
GridX	通用宫格控件	支持任意数量宫格（1-100项）、两种布局模式（固定大小留空缺/平均填充）、自动计算行列布局
MetroTilePanel	磁贴面板容器	支持流式布局、自动换行、分组管理
MetroTileItem	磁贴项控件	支持标题、副标题、图标显示
TabWorkspace	标签工作区控件	类似 Edge 浏览器的标签页工作区，支持标签头、工具面板、内容区域
TabHeaderEx	标签页标题栏控件	支持多标签管理、添加/关闭标签、系统按钮、窗体拖动、双击关闭
TabControl	增强型标签控件	支持多标签管理、四种标签位置、分割线显示、激活指示线、滚动支持
TabControlMenu	菜单式标签控件	左侧菜单导航、多页面管理、设计时拖放、自动命名、关联删除
ContextMenuEx	内容菜单控件	智能位置检测、多级菜单、图标、快捷键、分割线、主题适配、圆角、动画
RadialMenu	径向菜单控件	圆形展开菜单、支持 Segment 和 Circular 两种模式、平滑动画、主题适配

数据显示控件

控件名称	中文名称	说明
Tree	树形控件	层级结构展示、展开收起、单选/多选、复选框、SVG图标、连接线
ComboTreeView	下拉树控件	支持单选/多选模式、级联选择、自定义下拉尺寸
Statistic	统计数值控件	支持前缀/后缀、SVG图标、数值动画、倒计时/正计时、千分位分隔
GaugeControl	仪表盘控件	支持指针指示、刻度显示、数值标签、铭牌
GaugeControl180	180度仪表盘控件	半圆仪表盘，支持多种样式
CircleGauge	圆形仪表盘控件	支持多种样式、刻度显示、动画效果
SimpleGauge	简单仪表盘控件	简洁的仪表盘显示
CircularProgress	圆形进度条控件	支持多种风格、填充方向、填充样式
PercentageProgress	百分比进度条控件	支持多种风格、填充方向、动画效果
ProgressBar	进度条控件	支持多种样式、状态显示、文本显示
ProgressGear	齿轮进度指示器控件	支持旋转动画、多种齿轮样式
Battery	电池电量控件	支持横向和纵向显示、自动颜色切换
Signal	信号强度控件	支持柱状图和线条两种样式、加载动画
Thermometer	温度计控件	支持刻度显示、动画效果、异常值颜色提示
LCDDisplay	LCD数码管显示控件	支持七段显示、多种字符、时间模式
LCDTime	LCD时间显示控件	液晶风格日期时间显示
AlarmLight	报警灯控件	支持三色切换、闪烁动画、声音指示
Rate	评分控件	支持半星效果、自定义长度、只读模式、自定义颜色
StatusValueLabel	状态数值标签控件	支持标题数值显示、圆角边框、对齐方式
LabeledValue	标签值控件	支持主副标题显示、预置颜色样式
SideBySideLabel	并排标签控件	支持左右对比显示、斜切柱状图

图表控件

控件名称	中文名称	说明
PieChart	饼状图控件	支持点击偏移动画、百分比显示、图例显示、主题适配
BarPlot	柱状图控件	参考 ScottPlot 设计、亮暗主题、色彩模式、值标签、对比柱状图、边距控制、主题适配
ScatterPlot	散点图/折线图控件	支持平滑曲线、多种X轴类型、网格线、值提示、图例位置控制、主题适配
LinearGauge	线性刻度计控件	可作为温度计、液位计、刻度进度条、进度仪表使用
Timeline	时间轴控件	支持横向和纵向显示、节点自定义、当前节点高亮

导航与分页

控件名称	中文名称	说明
Pagination	分页器控件	支持标准/迷你/简易三种样式、亮暗主题、多种对齐方式、页码跳转

导航控件

控件名称	中文名称	说明
Breadcrumb	面包屑控件	支持多种样式、图标显示、点击事件
Steps	步骤条控件	引导用户按照流程完成任务的导航条，支持水平/垂直方向、自定义状态、点击切换
ImageCarousel	图片轮播控件	支持多种切换效果、自动轮播、指示器自定义
NavigationPad	导航按钮控件	支持上下左右导航、点击事件
NavigationMenuEx	导航菜单控件	支持横向/纵向布局、图标+文字多种组合、子菜单、圆角边框、宽度自适应、主题适配

输入控件

控件名称	中文名称	说明
ColorPicker	颜色选择器控件	支持Hex/RGB显示、预设颜色、饱和度/明度/色相选择、清除/重置功能、主题适配
ColorPalette	多彩主题选择控件	12种Ant Design主色、点击查看10个渐变等级、自动应用主题色、布局自定义
IPInputBox	IP地址输入框控件	支持IP地址分段输入、自动跳转
TimeInputBox	时间输入框控件	支持时分秒输入、自动跳转
NumpadTextBox	数字键盘输入框控件	支持数字键盘输入、精度控制
SelectNumber	数字选择控件	支持增减按钮、数值选择
NumPadEx	数字键盘控件	4x4网格布局数字输入面板

图表控件

控件名称	中文名称	说明
BarPlot	柱状图控件	参考 ScottPlot 设计、亮暗主题、色彩模式、值标签、对比柱状图、边距控制
ScatterPlot	散点图/折线图控件	支持平滑曲线、多种X轴类型、网格线、值提示、图例位置控制

音频可视化

控件名称	中文名称	说明
AudioSpectrumBar	音频频谱柱状图控件	积木块效果、自由落体峰值保持、线程安全、32/64频段、渐变颜色、透明背景
AudioSpectrumBarEx	音频频谱柱状图(增强版)	阻尼弹跳效果、可配置物理参数、与基础版API兼容，文档见 AudioSpectrumBar.md

工业控件

控件名称	中文名称	说明
SpeedControl	速度表控件	支持指针指示、刻度显示、颜色区域
GearSwitch	档位选择控件	支持多种档位、自动复位
Fan	风扇控制控件	支持旋转动画、速度控制
OilTank	油罐控件	支持液位显示、波浪动画
ConveyorBelt	传送带控件	支持流动动画、速度控制
Pipe	管道控件	支持流动动画、方向控制
PipeValve	管道阀门控件	支持开关状态、旋转动画
Blower	鼓风机控件	支持旋转动画、速度控制
IndustrialButton	工业按钮控件	支持指示灯、颜色自定义
RockerSwitch	船型开关控件	支持开关状态、颜色自定义
KnobSwitch	旋钮开关控件	支持旋转调节、多档位
PowerButton	电源按钮控件	支持发光效果、点击动画
SwitchPanel	86型开关面板控件	支持单开/双开、指示灯

按钮控件

控件名称	中文名称	说明
ShadowButton	阴影按钮控件	支持倒影效果、多种形状
MediaActionButton	媒体播放器控制按钮	支持多种媒体控制图标
ButtonsGroup	按钮组控件	支持单选按钮组、多种排列方式

列表控件

控件名称	中文名称	说明
ImageTextList	图文列表控件	支持图片、标题、副标题显示
InfoVPanel	竖版信息面板控件	适用于加油枪状态显示
InfoHPanel	横版信息面板控件	适用于加油枪状态显示

其他控件

控件名称	中文名称	说明
Preview	图片预览控件	支持滚轮缩放、旋转、翻页、左右导航按钮、遮罩层、静态方法调用
LabelTimeEx	时间文本控件	实时显示当前时间和日期，支持秒显示切换、SVG图标、透明背景、自动尺寸
CalendarEx	日历控件	支持日期选择、农历显示、范围限制
ClockEx	时钟控件	支持模拟时钟显示、日历显示、声音提示
Divider	分割线控件	支持多种方向、线条类型、文本显示
Arrow	箭头控件	单/双向箭头、任意角度旋转、实心/空心样式、自定义尺寸
OrgChart	组织结构图控件	多种布局方向、展开收起、自定义节点样式、丰富连接线样式
Tag	标签控件	支持多种形状、动画效果、文本方向、SVG图标、主题适配
RipplePanel	涟漪面板控件	带点击涟漪动画效果的容器面板，可放置子控件，继承自 Panel
Captcha	验证码控件	支持多种复杂度、干扰点、点击刷新
ScratchCode	刮刮卡/防伪码控件	支持鼠标擦除涂层、多种验证码类型、干扰线、擦除进度检测、校验功能
SliderCaptcha	滑动验证码控件	支持三种验证类型（拼图滑块、旋转验证、文字顺序点击）、多种拼图形状、自定义背景图片、右键刷新、主题适配
ImageLockScreen	手势图案锁屏控件	支持九宫格手势密码
Avatar	头像控件	支持圆形/方形形状、渐变发光效果、文本/图片/SVG图标内容、角标Badge显示
Image3D	3D翻转图片控件	支持圆角效果、多种图片显示模式、3D翻转动画（左右/上下翻转）、边框/阴影效果、水印显示、内边距支持
MagicWaterDrop	魔法水滴控件	支持点击涟漪动画效果（覆盖层方式，不建议使用）
TooltipEx	文字提示气泡框控件	支持12个位置、颜色主题、箭头显示/隐藏、偏移量
Watermark	水印控件	支持文字/图片/SVG水印、平铺显示、旋转、透明度调节
ScreenCapture	屏幕截图工具	支持区域截图、全屏截图、滚动长图、剪贴板/文件保存

文档格式说明

每个控件文档包含以下部分：

1. 控件名称 - 控件的英文名称
2. 中文名称 - 控件的中文名称
3. 控件优点 - 控件的主要特性和适用场景
4. 重要参数说明 - 控件的属性列表，包括类型、默认值和说明
5. 重要事件 - 控件支持的事件列表
6. 使用示例 - 控件的使用代码示例
7. 注意事项 - 使用控件时需要注意的事项

颜色规范

本项目支持两套颜色系统：Ant Design 品牌色（推荐）和 Layui 色调。

Ant Design 品牌色（推荐）

采用 Ant Design 的蓝色色板作为品牌主色，所有颜色定义在 AntDesignColors 静态类中。

品牌主色 - 蓝色色板 (Blue)

色值	颜色代码	用途	预览
Blue1	#e6f7ff	选择后背景色
Blue2	#bae7ff	-
Blue3	#91d5ff	-
Blue4	#69c0ff	-
Blue5	#40a9ff	Hover色
Blue6	#1890ff	默认色/Normal色
Blue7	#096dd9	Click色/点击色
Blue8	#0050b3	-
Blue9	#003a8c	-
Blue10	#002766	-

功能色

颜色名称	色值	说明	预览
Primary	#1890ff	品牌主色 (Blue6)
PrimaryHover	#40a9ff	Hover状态色 (Blue5)
PrimaryClick	#096dd9	Click状态色 (Blue7)
PrimarySelectedBg	#e6f7ff	选择后背景色 (Blue1)
Link	#1890ff	链接色（消息色）
Success	#52c41a	成功色
Warning	#faad14	警告色
Error	#f5222d	错误色

使用示例

// 使用品牌主色
button.BackColor = AntDesignColors.Primary;        // 默认色 #1890ff
button.HoverColor = AntDesignColors.PrimaryHover;  // Hover色 #40a9ff
button.ClickColor = AntDesignColors.PrimaryClick;  // 点击色 #096dd9

// 使用蓝色色板
panel.BackColor = AntDesignColors.Blue1;   // 最浅背景色
label.ForeColor = AntDesignColors.Blue6;   // 主色

// 使用功能色
statusLabel.ForeColor = AntDesignColors.Success;  // 成功状态
warningLabel.ForeColor = AntDesignColors.Warning; // 警告状态
errorLabel.ForeColor = AntDesignColors.Error;     // 错误状态

Layui 色调（兼容）

本项目同时保留 Layui 的颜色规范，所有颜色定义在 LayuiColors 静态类中。

基色调（Primary Colors）

用于主要按钮、链接、品牌标识等。

颜色名称	色值	说明	预览
Teal	#16baaa	蓝绿色 - 主色调之一，清新自然
Green	#16b777	清新绿 - 成功、积极
Blue	#1e9fff	经典蓝 - 信息、链接

辅色调（Secondary Colors）

用于状态提示、警告信息等。

颜色名称	色值	说明	预览
Danger	#ff5722	错误红 - 危险、错误
Warning	#ffb800	警示橙 - 警告、注意
Success	#16b777	成功绿 - 成功状态
Info	#31bdec	信息蓝 - 提示信息

七色调（Seven Colors）

完整的七种主题色，用于控件主题切换。

颜色名称	色值	预览
Red	#ff5722
Orange	#ffb800
SevenGreen	#16baaa
SevenBlue	#1e9fff
Purple	#a233c6
Dark	#2f363c
Light	#fafafa

中色调（Neutral Colors）

灰度色系，用于背景、边框、文字等。

颜色名称	色值	说明	预览
Gray50	#fafafa	最浅灰 - 背景色
Gray100	#f7f7f7	浅灰 - 背景色
Gray200	#eeeeee	灰白 - 边框、分割线
Gray300	#e2e2e2	浅灰 - 禁用状态
Gray400	#dddddd	中灰 - 边框
Gray500	#d2d2d2	灰色 - 占位符
Gray600	#cccccc	深灰 - 禁用文字
Gray700	#c2c2c2	更深灰 - 次要文字
Gray800	#2f363c	暗灰 - 深色背景
Gray900	#23292e	最深灰 - 深色文字

文本颜色

颜色名称	色值	说明	预览
TextPrimary	#333333	主要文本颜色
TextSecondary	#666666	次要文本颜色
TextMuted	#999999	辅助文本颜色
TextPlaceholder	#c2c2c2	占位符文本颜色

边框颜色

颜色名称	色值	说明	预览
Border	#e6e6e6	默认边框颜色
Divider	#eeeeee	分割线颜色

使用示例

// 直接使用颜色
button.BackColor = LayuiColors.Teal;
button.ForeColor = LayuiColors.TextPrimary;

// 根据主题获取颜色
ControlTheme theme = ControlTheme.Blue;
button.BackColor = LayuiColors.GetColor(theme);

// 获取浅色版本（用于悬停效果）
button.HoverColor = LayuiColors.GetLightColor(ControlTheme.Teal, 200);

// 获取深色版本（用于按下效果）
button.PressedColor = LayuiColors.GetDarkColor(ControlTheme.Teal);

// 使用灰度色
panel.BackColor = LayuiColors.Gray100;
textBox.BorderColor = LayuiColors.Border;
label.ForeColor = LayuiColors.TextSecondary;

快速开始

// 创建控件
ButtonEx button = new ButtonEx();
button.Text = "点击我";
button.Size = new Size(120, 40);
this.Controls.Add(button);

// 事件处理
button.Click += (sender, e) =>
{
    MessageBox.Show("按钮被点击！");
};

版本信息

• 文档版本：1.9.5
• 最后更新：2026-06-17
• 控件库版本：v1.9.5
• 控件总数：127
• 文档总数：143
• 平台支持：.NET 8+ / Windows