还在为WinForms应用的参数配置界面而心力交瘁吗？手动拖拽控件、写绑定、搞验证、调样式……每一个配置页都是重复的“苦力活”。
是时候改变了。
ZL.ParamEditor 是一个专为 WinForms 打造的高性能参数编辑器框架。它不是你熟悉的另一个控件库，而是一种声明式的开发范式——你只需描述“参数是什么”，框架自动为你生成“交互界面”。
痛点终结者：传统开发 vs. ZL.ParamEditor
| 你的传统困境 | ZL.ParamEditor 的解决之道 |
|---|---|
| 效率低下：每个参数都需手动创建UI控件和事件逻辑。 | 声明式开发：定义 ParameterDescriptor 列表，UI自动渲染，开发速度提升70%+。 |
| 样式陈旧：WinForms默认界面老旧，实现主题切换困难。 | 🎨 运行时主题系统：内置浅色、深色等多套专业主题，支持一键切换与完全自定义。 |
验证繁琐：在各个控件的Validating事件中编写重复的验证逻辑。 |
✔️ 强大验证框架：在参数描述中声明规则（必填、正则、范围），框架自动接管验证与错误提示。 |
| 扩展性差：遇到特殊参数类型（如时间计划），需大改代码，侵入性强。 | 🏭 编辑器工厂模式：轻松注册你的自定义编辑器，无缝集成特殊业务控件，不改动核心框架。 |
权限混乱：用if-else控制控件的Enabled和Visible，逻辑分散。 |
👥 角色权限系统：在参数描述中指定所需角色，框架自动根据当前用户角色控制UI状态。 |
核心优势：不只是控件，是生产力
-
⚡ 极致效率：从“编码UI”到“描述参数”，解放生产力。
-
🎨 颜值担当：提供现代化、可主题化的专业界面，提升产品质感。
-
🛡️ 数据堡垒：内置验证与权限，从源头保障数据准确与安全。
-
🚀 无限扩展：通过工厂模式，可轻松集成任何自定义控件，应对所有复杂场景。
无限可能：你的编辑器，你做主
ZL.ParamEditor 的核心魔力在于 ControlEditorFactoryRegistry。它让你可以轻松扩展任何类型的参数编辑器。
| 编辑器类型 | 描述与内置能力 | 你的自定义扩展 (示例) |
|---|---|---|
| 文本输入 | 单行、多行、密码框。 | TextEditorFactory (内置) |
| 数值选择 | 整型、浮点型数字输入。 | NumberEditorFactory (内置) |
| 布尔选择 | 复选框。 | CheckboxEditorFactory (内置) |
| 选项选择 | 下拉列表。 | DropdownEditorFactory (内置) |
| 路径选择 | 文件、文件夹选择对话框。 | FilePathEditorFactory (内置) |
| 日期/颜色 | 日期选择器、颜色选择器。 | DatePickerFactory, ColorPickerFactory (内置) |
| 集合编辑 | 编辑字符串列表、甚至数据表格。 | StringArrayEditorFactory, GridEditorFactory (内置) |
| 💡 完全自定义 | 集成任何WinForms UserControl。 | ScheduleEditorFactory (用于时间计划)EnumRadioGroupEditorFactory (用于单选按钮组) |
这意味着什么？ 无论你的业务参数多么独特——一个复杂的时间排程器、一个带预览的图片选择器，或是一个动态公式编辑器——你都可以为其创建一个专用的UserControl，并通过简单的工厂注册，使其成为框架原生支持的一部分。
三行代码，开启高效之旅
告别繁琐，体验声明式开发的优雅。
// 1. 创建编辑器（选择主题）
var editor = GenericParameterEditorConfig.CreateDark();// 2. 定义你的参数结构（这才是业务逻辑！）
var descriptors = new List<ParameterDescriptor> {new() { Key = "SiteName", DisplayName = "站点名称", Editor = EditorType.Text, IsRequired = true },new() { Key = "RetryCount", DisplayName = "重试次数", Editor = EditorType.Number, DefaultValue = 3 },new() { Key = "DailySchedule", DisplayName = "每日计划", Editor = EditorType.CustomSchedule } // 你的自定义编辑器！
};// 3. 绑定数据与角色，完成！
var configData = LoadConfig();
editor.Bind(configData, descriptors, UserRole.Admin);
// 一个功能完整、美观、带验证和权限的配置界面已就绪！
立即尝试 ZL.ParamEditor，你将再也回不去手动编写配置界面的时代。
让框架处理重复的UI劳动，而你，专注于创造真正的业务价值。
两个简单的例子：
- JSON配置文件 维护
- 复杂步骤参数维护
