控件开发了一段时间,花费了不少精力开发与测试,无法全部一一更新,示例图如下,不分先后顺序,没有分类。还要花费时间进行各种测试,如有时间会一一补充。
参考了 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 | 增强分割容器控件 | 支持折叠/展开、圆角按钮、智能比例保持、双击切换 |
| Collapse | 折叠面板控件 | 参考Ant Design Collapse设计,支持面板展开/折叠、手风琴模式、平滑动画、主题支持、FillRemaining铺满剩余空间、文本/控件内容 |
| Table | 表格控件 | 支持多种数据类型(文本、数字、布尔、图片、标签、进度条、链接、图标、图标+文本)、表头固定、复选框选择、斑马纹、排序、列宽调整、主题支持、滚动条悬停显示、自定义滚动条颜色、INotifyPropertyChanged 属性变更通知 |
加载与反馈
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| SpinEx | 加载动画控件 | 支持多种动画类型、半透明遮罩、SVG图标、点击关闭、Layered Window技术 |
| WaitingBar | 等待进度条控件 | 滑块左右来回移动、平滑缓动动画、圆角样式、多种颜色主题、不阻塞线程 |
| TrackBar | 滑动条控件 | 支持横向/纵向、刻度显示、圆角样式、倒序排列、主题适配 |
基础控件
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| ButtonEx | 按钮控件 | 支持多种形状、颜色类型、SVG图标(Ant Design 功能色) |
| FloatButtonEx | 悬浮按钮控件 | 支持多个按钮排列、SVG图标、徽标、加载状态 |
| LabelEx | 标签控件 | 支持横向/纵向布局、超链接、旋转、跑马灯 |
| InputBox | 输入框控件 | 支持前缀后缀图标、占位符、清除按钮 |
| NumberBox | 数字输入框控件 | 支持增减按钮、精度控制、范围限制 |
| ComboBoxEx | 下拉框控件 | 支持多种样式、圆角边框、自定义颜色 |
| 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 | 迷你消失提示框 | 在触发控件上方弹出,向上移动后淡出消失,支持四种消息类型 |
窗体与容器
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| UIForm | 自定义窗体基类 | 无边框窗体、自定义标题栏、阴影效果、圆角边框、亮暗主题切换、子控件递归主题传递 |
| DrawerEx | 抽屉组件 | 四方向滑入面板、窗体/控件级显示、支持任意内容载体、可配置按钮位置、系统级关闭按钮样式、平滑动画、可拖拽调整大小 |
| GroupBox | 分组框控件 | 支持多种标题位置、折叠功能、闪烁提示 |
| ExplorerBar | 资源管理器栏控件 | 支持分组管理、展开/折叠、图标显示 |
| Transfer | 穿梭框控件 | 支持双向数据穿梭、搜索过滤、双击转移 |
| Grid4 | 四宫格控件 | 2x2网格布局,支持图标、文本、徽章 |
| Grid9 | 九宫格控件 | 3x3网格布局,支持图标、文本、徽章 |
| Grid16 | 十六宫格控件 | 4x4网格布局,支持图标、文本、徽章 |
| 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 | 状态数值标签控件 | 支持标题数值显示、圆角边框、对齐方式 |
| DualTextLabel | 双文本标签控件 | 支持主副标题显示、预置颜色样式 |
| ComparisonLabel | 对比标签控件 | 支持左右对比显示、斜切柱状图 |
图表控件
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| PieChart | 饼状图控件 | 支持点击偏移动画、百分比显示、图例显示、主题适配 |
| BarPlot | 柱状图控件 | 参考 ScottPlot 设计、亮暗主题、色彩模式、值标签、对比柱状图、边距控制、主题适配 |
| ScatterPlot | 散点图/折线图控件 | 支持平滑曲线、多种X轴类型、网格线、值提示、图例位置控制、主题适配 |
| LinearGauge | 线性刻度计控件 | 可作为温度计、液位计、刻度进度条、进度仪表使用 |
| Timeline | 时间轴控件 | 支持横向和纵向显示、节点自定义、当前节点高亮 |
导航与分页
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| Pagination | 分页器控件 | 支持标准/迷你/简易三种样式、亮暗主题、多种对齐方式、页码跳转 |
导航控件
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| Breadcrumb | 面包屑控件 | 支持多种样式、图标显示、点击事件 |
| Steps | 步骤条控件 | 引导用户按照流程完成任务的导航条,支持水平/垂直方向、自定义状态、点击切换 |
| ImageCarousel | 图片轮播控件 | 支持多种切换效果、自动轮播、指示器自定义 |
| NavigationButton | 导航按钮控件 | 支持上下左右导航、点击事件 |
| 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 | 档位选择控件 | 支持多种档位、自动复位 |
| FanControl | 风扇控制控件 | 支持旋转动画、速度控制 |
| OilTank | 油罐控件 | 支持液位显示、波浪动画 |
| ConveyorBelt | 传送带控件 | 支持流动动画、速度控制 |
| Pipe | 管道控件 | 支持流动动画、方向控制 |
| PipeValve | 管道阀门控件 | 支持开关状态、旋转动画 |
| Blower | 鼓风机控件 | 支持旋转动画、速度控制 |
| IndustrialButton | 工业按钮控件 | 支持指示灯、颜色自定义 |
| RockerSwitch | 船型开关控件 | 支持开关状态、颜色自定义 |
| KnobSwitch | 旋钮开关控件 | 支持旋转调节、多档位 |
| PowerButton | 电源按钮控件 | 支持发光效果、点击动画 |
| SwitchPanel | 86型开关面板控件 | 支持单开/双开、指示灯 |
按钮控件
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| ShadowButton | 阴影按钮控件 | 支持倒影效果、多种形状 |
| MediaPlayerButton | 媒体播放器控制按钮 | 支持多种媒体控制图标 |
| ButtonsGroup | 按钮组控件 | 支持单选按钮组、多种排列方式 |
列表控件
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| ImageTextList | 图文列表控件 | 支持图片、标题、副标题显示 |
| InfoVPanel | 竖版信息面板控件 | 适用于加油枪状态显示 |
| InfoHPanel | 横版信息面板控件 | 适用于加油枪状态显示 |
其他控件
| 控件名称 | 中文名称 | 说明 |
|---|---|---|
| LabelTimeEx | 时间文本控件 | 实时显示当前时间和日期,支持秒显示切换、SVG图标、透明背景、自动尺寸 |
| CalendarEx | 日历控件 | 支持日期选择、农历显示、范围限制 |
| ClockEx | 时钟控件 | 支持模拟时钟显示、日历显示、声音提示 |
| Divider | 分割线控件 | 支持多种方向、线条类型、文本显示 |
| TagEx | 标签控件 | 支持多种形状、动画效果、文本方向 |
| RipplePanel | 涟漪面板控件 | 带点击涟漪动画效果的容器面板,可放置子控件,继承自 Panel |
| Captcha | 验证码控件 | 支持多种复杂度、干扰点、点击刷新 |
| ScratchCode | 刮刮卡/防伪码控件 | 支持鼠标擦除涂层、多种验证码类型、干扰线、擦除进度检测、校验功能 |
| SliderCaptcha | 滑动验证码控件 | 支持三种验证类型(拼图滑块、旋转验证、文字顺序点击)、多种拼图形状、自定义背景图片、右键刷新、主题适配 |
| ImageLockScreen | 手势图案锁屏控件 | 支持九宫格手势密码 |
| Avatar | 头像控件 | 支持圆形/方形形状、渐变发光效果、文本/图片/SVG图标内容、角标Badge显示 |
| Image3D | 3D翻转图片控件 | 支持圆角效果、多种图片显示模式、3D翻转动画(左右/上下翻转)、边框/阴影效果、水印显示、内边距支持 |
| MagicWaterDrop | 魔法水滴控件 | 支持点击涟漪动画效果(覆盖层方式,不建议使用) |
| TooltipEx | 文字提示气泡框控件 | 支持12个位置、颜色主题、箭头显示/隐藏、偏移量 |
| Watermark | 水印控件 | 支持文字/图片/SVG水印、平铺显示、旋转、透明度调节 |
文档格式说明
每个控件文档包含以下部分:
- 控件名称- 控件的英文名称
- 中文名称- 控件的中文名称
- 控件优点- 控件的主要特性和适用场景
- 重要参数说明- 控件的属性列表,包括类型、默认值和说明
- 重要事件- 控件支持的事件列表
- 使用示例- 控件的使用代码示例
- 注意事项- 使用控件时需要注意的事项
颜色规范
本项目支持两套颜色系统: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;// 默认色 #1890ffbutton.HoverColor=AntDesignColors.PrimaryHover;// Hover色 #40a9ffbutton.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;// 根据主题获取颜色ControlThemetheme=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;快速开始
// 创建控件ButtonExbutton=newButtonEx();button.Text="点击我";button.Size=newSize(120,40);this.Controls.Add(button);// 事件处理button.Click+=(sender,e)=>{MessageBox.Show("按钮被点击!");};版本信息
- 文档版本:1.8.1
- 最后更新:2026-06-02
- 控件库版本:v1.8.8
- 控件总数:100+
- 平台支持:.NET 8+ / Windows