Zhouyaowei.ZYWControls — nugetz
Zhouyaowei/Zhouyaowei.ZYWControlsv1.0.23
.NET 9.0-windows7.0
WinForm 按钮，单行文本，多行文本，下拉列表框，表格，日期选择器,标签控件 / 标签页控件,窗体标签控件,图片播放控件,开关控件
Get Started
$ dotnet add package Zhouyaowei.ZYWControlsReadme
ZYWControls - 增强型WinForm控件库
ZYWControls 是一套基于 .NET 9.0 Windows Forms 的增强型控件库，提供多种高频使用的自定义控件。控件支持可视化设计器配置、丰富的外观自定义和实用的数据处理功能，帮助开发者快速构建美观、高效的WinForm应用。
🔧 安装说明
通过 NuGet 包管理器快速安装：
Install-Package Zhouyaowei.ZYWControls
或通过 .NET CLI 安装：
dotnet add package Zhouyaowei.ZYWControls
环境要求
- .NET 9.0 及以上
- Windows 操作系统（依赖 Windows Forms）
- 支持设计器的 IDE（Visual Studio 2022+ 推荐）
📋 控件清单及核心功能
1. ZYWButton - 圆角呼吸灯按钮
- 支持自定义圆角半径（0-任意整数）
- 三种状态渐变颜色配置（默认/悬停/按下）
- 可选呼吸灯动画（可调节速度、幅度）
- 内置多类型数据绑定（字符串/整型/Action委托等）
2. ZYWComboBox - 增强型下拉框
- 支持自定义边框（颜色、粗细、各边可见性）
- 键值对（KeyValueItem）数据绑定，支持附加对象
- 提供DataTable/列表数据加载、选中项快速定位
- 线程安全的Items集合操作，避免UI卡顿
3. ZYWDatePicker - 智能日期选择器
- 自定义边框样式与ZYWTextBox保持视觉统一
- 预设8种默认日期（当天/本周首尾/本月首尾等）
- 支持自定义日期偏移（当前日期±N天）
- 天级时间戳转换（基于指定起始日期）
4. ZYWMemoBox - 多行文本框
- 强制多行模式，支持回车/制表符输入
- 自定义边框+滚动条配置
- 文本插入/追加操作，自动清除超限内容
- 支持TXT/HTML文件读写（自动识别编码）
5. ZYWTabControl - 圆角标签页
- 标签圆角半径、边框颜色/粗细自定义
- 支持标签渐变背景（默认/选中状态分别配置）
- 标签宽高固定设置，避免自适应混乱
- 高质量绘制，无闪烁、无锯齿
6. ZYWTableView - 高级表格控件
- 奇偶行交替背景色，选中行高亮样式自定义
- 行号显示控制（显示/隐藏、宽度调整）
- 列配置持久化（保存/加载/重置列布局）
- 支持DataTable绑定，选中行数据快速提取
- 列编辑功能（通过配置文件调整表头/可见性/冻结状态）
7. ZYWTextBox - 增强型单行文本框
- 支持占位符提示（文本/颜色自定义）
- 四种输入类型限制（整型/小数/正数等）
- 自定义边框样式，支持单独控制各边显示
- 禁止粘贴非法内容，输入实时校验
8. ZYWFormTabControl - 窗体标签控件
- 全方位样式自定义
- 人性化交互功能
- 窗体嵌入核心能力
- 设计器友好性
9. ZYWPlayPictureBox - 图片播放控件
- 灵活的播放控制
- 状态自动切换
- 高性能与安全性
- 资源友好
10. ZYWToggleSwitch - 开关控件
- 基础交互能力
- 高度可定制化样式
- 开发友好特性
- 事件支持
🎨 快速使用示例
1. ZYWButton 呼吸灯按钮示例
var btn = new ZYWControls.ZYWButton();
btn.Text = "提交";
btn.CornerRadius = 10; // 圆角半径
btn.BreathingEffectActive = true; // 启用呼吸灯
btn.BreathingInterval = 30; // 动画流畅度
btn.BreathingChange = 40; // 颜色变化幅度
btn.Click += (s, e) => MessageBox.Show("按钮点击触发");
this.Controls.Add(btn);
2. ZYWTableView 表格数据绑定示例
// 1. 创建表格控件
var tableView = new ZYWControls.ZYWTableView();
tableView.Dock = DockStyle.Fill;
tableView.RowOddBackColor = Color.White;
tableView.RowEvenBackColor = Color.FromArgb(245, 245, 245);
// 2. 准备测试数据
var dt = new DataTable();
dt.Columns.Add("ID", typeof(int));
dt.Columns.Add("Name", typeof(string));
dt.Rows.Add(1, "测试数据1");
dt.Rows.Add(2, "测试数据2");
// 3. 绑定数据
var result = tableView.LoadData(dt);
if (!result.isok)
{
MessageBox.Show(result.msg);
}
this.Controls.Add(tableView);
3. ZYWTextBox 带占位符和输入限制
var txt = new ZYWControls.ZYWTextBox();
txt.Placeholder = "请输入正数（最多2位小数）";
txt.PlaceholderColor = Color.LightGray;
txt.InputType = ZYWControls.ZYWTextBox.InputDataType.正数小数;
txt.BorderBottomVisble = true; // 仅显示底边框
txt.BorderColor = Color.FromArgb(0, 100, 180);
this.Controls.Add(txt);
⚙️ 设计器支持
所有控件的自定义属性均已分类整理，在Visual Studio设计器中可直接配置：
- 外观扩展：边框、颜色、圆角等样式属性
- 数据扩展：默认值、输入限制、数据绑定等
- 动画效果：仅ZYWButton的呼吸灯相关配置
📌 版本信息
- 当前版本：1.0.10
- 更新日志：
- v1.0.10：包含10种核心控件
- 支持设计器可视化配置
- 完善的异常处理和资源释放
🤝 反馈与贡献
- 若发现BUG或有功能需求，请提交Issue
- 欢迎Fork仓库，提交Pull Request完善控件功能
Feb 9, 2026