简介这是一套面向C# WinForm开发者的自定义控件合集适合希望提升桌面应用界面质感与交互体验的中级开发者。资源以SunnyUI为核心涵盖自定义Button、进度条、对话框与提示框等常用组件并配套一套统一的外观设计方案可帮助开发者快速构建现代风格的WinForm界面减少从零绘制控件的时间成本。压缩包共480个文件约6.05MB其中272个cs源码文件是控件实现主体67个png与2个ttf、2个ico提供图标和字体资源50个resx与50个resources承载本地化与资源定义另有csproj、sln、nuspec等工程与打包文件便于直接编译和二次开发。目前已有1335人学习下载读者可从中获取控件源码、设计时支持、示例工程结构以及外观定制思路适合用于项目界面改造或自定义控件学习参考。1. 从 SunnyUI 说起一个 C# 自定义控件合集到底能省下多少重复活做过 WinForms 项目的人大概都有这种体验界面需求明明不复杂但系统自带的 Button、DataGridView、TabControl 长得实在太“原生”客户看一眼就皱眉。于是你开始自己画边框、重写 OnPaint、处理鼠标悬停状态、调圆角、搞主题色切换……一个项目下来光 UI 层就写了上千行重复代码。SunnyUI 这类 C# 自定义控件合集解决的正是这个问题——它把按钮、输入框、表格、树、选项卡、进度条、消息提示等常用控件做了一次成体系的封装你直接引用就能得到一套风格统一、支持主题切换的界面。它适合两类人一是维护传统 WinForms 项目、不想引入 WPF 或 Web 技术栈的工程师二是需要快速交付内部工具、上位机、配置管理端对界面美观有要求但不想从零造轮子的开发者。这个合集以压缩包形式分发核心价值不在“控件多”而在“风格一致 主题可换 源码可改”。2. 控件库的选型逻辑与工程接入为什么不是随便拖几个第三方控件2.1 自绘控件和原生控件的本质差别WinForms 原生控件依赖系统主题渲染外观由操作系统决定。你在 Win10 上看到的按钮和 Win7 上不一样高 DPI 下还可能模糊。自定义控件的做法是接管绘制流程重写OnPaint用 GDI 自己画背景、边框、文字和图标。这样做的好处是外观完全可控坏处是你要自己处理状态管理——正常、悬停、按下、禁用、焦点每个状态都得有对应的绘制分支。SunnyUI 这类库的典型结构是每个控件继承自原生控件或Control基类内部维护一个UITheme对象所有颜色、圆角半径、字体都从主题对象读取。切换主题时不需要重建控件只需要通知重绘。这个设计决定了它的接入方式——不是简单拖一个 dll 就完事你需要理解它的初始化流程。2.2 把控件库接入现有项目的完整步骤假设你拿到的是一个源码形式的控件合集目录结构通常包含SunnyUI核心库、SunnyUI.Demo示例、SunnyUI.Demo.Charts图表扩展等。接入步骤如下第一步把核心库项目添加到你的解决方案或者直接引用编译好的 dll。如果引用源码项目注意目标框架要一致常见是 .NET Framework 4.6.2 以上或 .NET 6/8 的 Windows 目标。# 假设目录结构如下先确认目标框架 # SunnyUI/SunnyUI.csproj # 查看 TargetFramework 节点 grep -i TargetFramework SunnyUI/SunnyUI.csproj第二步在程序入口处初始化全局主题。这一步很多人会漏掉导致控件显示默认灰色。// Program.cs using Sunny.UI; static class Program { [STAThread] static void Main() { Application.EnableVisualStyles(); Application.SetCompatibleTextRenderingDefault(false); // 关键设置全局主题和样式 UIStyleManager.Style UIStyle.Blue; // 主题色 UIStyleManager.MultiPage true; // 多页面模式 UIStyleManager.ShowStatusForm false; // 不显示调试状态窗 Application.Run(new MainForm()); } }第三步把窗体基类从Form换成UIForm或者至少让窗体实现主题刷新接口。如果你只是把控件拖到普通Form上主题切换时控件可能不刷新。// MainForm.cs using Sunny.UI; public partial class MainForm : UIForm // 继承 UIForm 而不是 Form { public MainForm() { InitializeComponent(); // 窗体标题栏也会跟随主题 } }第四步在窗体上放置控件。设计器工具箱里会出现 SunnyUI 分类但更可靠的做法是手动写初始化代码避免设计器序列化问题。// 手动创建一个主题按钮 var btn new UIButton { Text 提交, Location new Point(20, 20), Size new Size(120, 36), Radius 6, // 圆角半径 Font new Font(微软雅黑, 10F) }; btn.Click (s, e) UIMessageBox.Show(操作完成); this.Controls.Add(btn);逻辑说明Radius控制圆角值越大越圆UIMessageBox是库自带的提示框风格和主题一致。参数方面UIStyleManager.Style可选值通常包括 Blue、Green、Red、Purple、Dark 等具体以你拿到的版本为准。如果切换主题后部分控件没变检查该控件是否在初始化时读取了主题对象而不是硬编码颜色。2.3 主题切换的底层机制与手动刷新主题切换不是简单的换色它涉及一次全局遍历。库内部通常维护一个已注册控件的列表切换时逐个调用SetStyle或Invalidate。如果你在运行时动态创建控件创建后需要手动注册。// 动态创建后注册到主题管理 var panel new UIPanel(); this.Controls.Add(panel); UIStyleManager.Register(panel); // 部分版本需要手动注册如果找不到Register方法说明该版本采用基类自动注册机制只要控件继承自UIBase系列即可。这时你要做的是确保动态控件也继承自库内基类而不是原生Panel。3. 从源码到可复用组件二次开发和样式定制的实操路径3.1 读懂控件的绘制入口要改样式先找到绘制入口。以按钮为例核心方法通常是OnPaint或PaintRect。打开源码搜索protected override void OnPaint你会看到类似结构protected override void OnPaint(PaintEventArgs e) { base.OnPaint(e); Graphics g e.Graphics; g.SmoothMode(); // 抗锯齿扩展方法 // 画背景 using (var brush new SolidBrush(GetFillColor())) { g.FillPath(brush, GetRoundRectPath()); } // 画边框 if (ShowRect) { using (var pen new Pen(GetRectColor(), RectSize)) { g.DrawPath(pen, GetRoundRectPath()); } } // 画文字 g.DrawString(Text, Font, new SolidBrush(ForeColor), ClientRectangle, TextAlign); }逻辑说明GetFillColor()根据当前状态悬停、按下返回不同颜色这些颜色来自主题对象。你要改按钮默认色就改主题定义而不是改这里。参数方面RectSize是边框宽度SmoothMode是抗锯齿开关关闭后性能略好但边缘有锯齿。3.2 自定义一个符合项目配色的主题如果内置主题都不满足可以扩展主题类。常见做法是继承UITheme并覆盖颜色属性。public class CustomTheme : UITheme { public CustomTheme() { // 覆盖关键颜色 this.PrimaryColor Color.FromArgb(0, 120, 215); this.PrimaryColorLight Color.FromArgb(200, 230, 255); this.PrimaryColorDark Color.FromArgb(0, 80, 160); this.ForeColor Color.FromArgb(33, 33, 33); this.BackColor Color.FromArgb(245, 245, 245); this.RectColor Color.FromArgb(200, 200, 200); } } // 应用 UIStyleManager.SetTheme(new CustomTheme());逻辑说明PrimaryColor是主色影响按钮、选中项、进度条PrimaryColorLight用于悬停背景PrimaryColorDark用于按下状态。参数值需要根据你的品牌色调整建议先用取色器拿到 RGB再填入。注意不要只改一个颜色否则悬停和按下状态会不协调。3.3 把定制后的控件打包成内部 NuGet 源如果团队多个项目都要用建议把改好的库打包成内部 NuGet 包。步骤# 在库项目目录下执行 dotnet pack -c Release -o ./nupkg # 输出类似 SunnyUI.3.2.0.nupkg # 然后推送到内部源 nuget push ./nupkg/SunnyUI.3.2.0.nupkg -Source http://your-internal-nuget/v3/index.json逻辑说明-c Release生成发布版-o指定输出目录。推送前确保版本号已更新否则会被拒绝。内部源地址由团队运维提供不要硬编码在脚本里用环境变量传入。4. 避坑与排查控件合集接入时最容易翻车的五个地方4.1 设计器报错或控件消失现象把控件从工具箱拖到窗体后设计器抛出异常或者控件显示为空白方块。 原因设计器加载控件时需要调用无参构造函数和InitializeComponent如果控件在构造函数里依赖了尚未初始化的主题对象就会失败。 解决确保控件的构造函数不直接读取UIStyleManager.Style而是延迟到OnPaint时读取。如果已经写死改成属性默认值加运行时覆盖。4.2 高 DPI 下模糊或错位现象在 125% 或 150% 缩放的屏幕上控件文字模糊边框粗细不均。 原因WinForms 默认 DPI 感知模式是系统级GDI 绘制时坐标被系统拉伸。 解决在 app.manifest 中启用 PerMonitorV2 DPI 感知并在初始化时调用Application.SetHighDpiMode(HighDpiMode.PerMonitorV2)。同时检查控件的Font是否用了固定像素单位建议用点单位。!-- app.manifest 片段 -- application xmlnsurn:schemas-microsoft-com:asm.v3 windowsSettings dpiAwareness xmlnshttp://schemas.microsoft.com/SMI/2016/WindowsSettingsPerMonitorV2/dpiAwareness /windowsSettings /application4.3 主题切换后部分控件不刷新现象点击切换主题大部分控件变了但某个自定义面板或动态创建的按钮还是旧颜色。 原因该控件没有注册到主题管理器或者它重写了OnPaint但没有调用基类方法。 解决检查控件是否继承自库内基类如果是原生控件手动调用Invalidate()并重新读取主题色。动态创建的控件在Controls.Add之后调用一次UIStyleManager.Register(control)。4.4 编译时报缺少依赖或版本冲突现象引用源码项目后编译提示找不到System.Drawing.Common或版本不一致。 原因控件库可能依赖了特定版本的 NuGet 包而你的项目引用了另一个版本。 解决用dotnet list package --include-transitive查看依赖树统一版本。如果目标框架是 .NET 6注意System.Drawing.Common在非 Windows 平台有限制WinForms 项目本身只跑 Windows问题不大但版本要对齐。4.5 打包后运行时找不到资源现象本地调试正常发布到其他机器后控件图片或图标丢失。 原因控件库可能通过Properties.Resources嵌入资源如果打包时裁剪了程序集或用了单文件发布资源可能没被正确加载。 解决检查发布配置确保SunnyUI.dll及其资源程序集一起复制。单文件发布时把控件库标记为不裁剪或者显式包含资源。!-- 发布配置片段 -- PublishSingleFiletrue/PublishSingleFile TrimmerRootAssembly IncludeSunnyUI /5. 进阶技巧用控件合集做一套可配置的界面骨架5.1 把主题配置外置到 JSON硬编码主题不利于交付后调整。我一般会把颜色配置抽到 JSON 文件启动时读取。{ Theme: { PrimaryColor: 0,120,215, PrimaryColorLight: 200,230,255, PrimaryColorDark: 0,80,160, ForeColor: 33,33,33, BackColor: 245,245,245 } }// 读取并应用 var json File.ReadAllText(theme.json); var config JsonSerializer.DeserializeThemeConfig(json); var theme new CustomTheme { PrimaryColor ParseColor(config.Theme.PrimaryColor), // ... 其他属性 }; UIStyleManager.SetTheme(theme);逻辑说明ParseColor把0,120,215转成Color.FromArgb。这样现场实施人员改 JSON 就能换配色不用重新编译。5.2 用基类窗体统一初始化逻辑每个窗体都写一遍主题初始化很烦。建一个BaseForm : UIForm在构造函数里做公共设置。public class BaseForm : UIForm { public BaseForm() { this.Font new Font(微软雅黑, 9F); this.StartPosition FormStartPosition.CenterParent; this.ShowTitle true; this.ShowRadius true; this.Radius 8; } }之后所有业务窗体继承BaseForm只关注业务逻辑。这个习惯能省掉大量重复代码也避免某个窗体漏设主题导致风格不一致。5.3 验证控件库是否值得长期维护的三个检查点第一看源码的更新频率和 issue 处理速度。如果最近一年没有提交遇到 .NET 新版本可能没人适配。第二看单元测试覆盖率没有测试的控件库在升级时容易引入回归。第三看是否支持你需要的目标框架比如 .NET 8 的 Windows 桌面项目。我自己的习惯是先拿一个边缘项目试水跑一个迭代周期确认没有阻塞性问题再推广到核心项目。控件库这东西省的是前期时间但如果你要深度定制后期维护成本也得算进去。希望帮到你。本文还有配套的精品资源点击获取