ZYWControlsNet48

控件库介绍

ZYWControlsNet48 是一套基于 .NET Framework 4.8 开发的 WinForm 自定义控件库，覆盖桌面端表单开发高频场景，解决原生控件样式单一、功能拓展性差的问题。控件库轻量化无第三方依赖，支持自定义样式、基础数据绑定，适配传统 WinForm 项目快速集成。

核心特性

整体特性

• ✅ 适配 .NET Framework 4.8，兼容传统 WinForm 项目；
• ✅ 无第三方依赖，仅依赖 .NET 内置类库，部署简单；
• ✅ 统一的样式设计体系，控件视觉风格一致；
• ✅ 支持设计器可视化操作，拖入即用；
• ✅ 扩展原生控件事件/属性，满足业务定制需求。

控件列表及核心能力

控件名称	核心能力
ZYWButton	自定义背景色/圆角/悬停样式，扩展点击事件防抖、自定义图标支持
ZYWComboBox	支持下拉项自定义渲染、模糊搜索、数据源一键绑定
ZYWDaterPicker	日期范围选择、自定义日期格式、快捷选择（今日/昨日/近7天）
ZYWMemoBox	多行文本自适应高度、字数统计、输入限制、回车换行优化
ZYWTabControl	选项卡自定义样式（下划线/圆角）、关闭按钮、拖拽排序、动态增删选项卡
ZYWTabelView	单元格样式自定义、行选中高亮、基础数据绑定、单元格编辑状态控制
ZYWTextBox	输入格式校验（手机号/邮箱/数字）、水印提示、密码隐藏/显示切换
ZYWFormTabControl	窗体嵌入、标签关闭、全方位样式自定义
ZYWPlayPictureBox	灵活的播放控制、状态自动切换、高性能与安全性、资源友好
ZYWToggleSwitch	基础交互能力、高度可定制化样式、开发友好特性、事件支持

安装方式

NuGet 包管理器安装

Install-Package ZYWControlsNet48

手动引用（备用）

1. 从 NuGet 下载 ZYWControlsNet48 包，解压获取 ZYWControlsNet48.dll；
2. 打开 WinForm 项目 → 右键“引用” → “添加引用” → “浏览” → 选中该 DLL；
3. 工具箱右键 → “选择项” → “浏览” → 选中 DLL，所有控件自动显示在工具箱中。

快速使用

步骤1：设计器快速集成

1. 安装包后，重启 Visual Studio；
2. 打开 WinForm 窗体设计器，在工具箱中找到「ZYWControls」分组；
3. 将需要的控件（如 ZYWButton）拖入窗体，即可可视化调整属性（大小、样式、事件等）。

步骤2：代码动态创建示例（以 ZYWButton 为例）

using ZYWControlsNet48.ZYWButton;

// 初始化自定义按钮
var customBtn = new ZYWButton();
// 设置基础样式
customBtn.Text = "自定义按钮";
customBtn.Width = 120;
customBtn.Height = 40;
customBtn.Radius = 8; // 圆角半径
customBtn.NormalBackColor = Color.FromArgb(51, 153, 255); // 正常状态背景色
customBtn.HoverBackColor = Color.FromArgb(71, 173, 255); // 悬停状态背景色
// 绑定点击事件
customBtn.Click += (sender, e) =>
{
    MessageBox.Show("自定义按钮点击触发！");
};
// 添加到窗体
this.Controls.Add(customBtn);
customBtn.Location = new Point(50, 50);

步骤3：数据源绑定示例（以 ZYWComboBox 为例）

using ZYWControlsNet48.ZYWComboBox;

// 初始化下拉框
var customCombo = new ZYWComboBox();
customCombo.Width = 200;
// 构造数据源
var dataList = new List<ComboItem>()
{
    new ComboItem() { Id = 1, Text = "选项1" },
    new ComboItem() { Id = 2, Text = "选项2" },
    new ComboItem() { Id = 3, Text = "选项3" }
};
// 绑定数据源
customCombo.BindData(dataList, "Id", "Text");
// 添加到窗体
this.Controls.Add(customCombo);
customCombo.Location = new Point(50, 100);

兼容性

框架版本	是否支持	备注
.NET Framework 4.8	✅	主适配版本
.NET Framework 4.7.2	✅	兼容运行
.NET Framework 4.6.2	⚠️	部分样式可能显示异常
.NET Core/.NET 5+	❌	仅支持 .NET Framework

常见问题

1. 问题：控件拖入设计器后显示异常？ 解决：确认项目目标框架为 .NET Framework 4.8，重启 Visual Studio 并重新加载项目；
2. 问题：自定义样式设置后不生效？ 解决：避免在窗体 Load 事件前设置样式，建议在 Shown 事件中调整控件样式；
3. 问题：数据源绑定后无数据？ 解决：检查绑定的字段名（Id/Text）与数据源对象属性名一致，确认数据源非空。

许可证

本项目基于 MIT 许可证开源 - 详见 LICENSE 文件。