二次开发说明
输入“/”快速插入内容
二次开发说明
二次开发说明
用户3521用户35213月29日修改
1.
概述
平台 UI 框架是一套完整的图形界面开发体系，提供了从底层控件到顶层页面管理的全栈支持。它基于 .NET WinForms 技术，融合了自研的控件库和成熟的第三方控件（如 HZHControls），实现了页面生命周期管理、控件属性系统、多语言、皮肤切换、设计时支持等核心功能。UI 框架的设计目标是让开发者能够快速构建工业级监控界面，同时保证界面的一致性、可维护性和扩展性。
UI 框架的核心组件包括：
•
主窗体（MainForm）：应用程序的主窗口，负责菜单栏、页面容器、状态栏等的布局与管理，通过 XML 导航配置文件动态生成菜单。
•
页面基类（PageBase）：提供页面的生命周期管理、定时刷新、多语言、皮肤、图标等基础能力。
•
控件基类（ControlBase）：为所有控件提供统一属性系统、鼠标交互、条件表达式、XML 配置等能力。
•
属性面板（PropertyPanel）：用于在设计时编辑控件属性的可视化工具。
•
设计器页面（GuiStandard）：一个特殊的业务页面，能够解析 UI 控件的 XML 配置，动态加载控件并支持拖拽布局、在线绑定 IO、保存/加载布局，是实现配置化界面的核心。
•
多语言与皮肤：内置多语言切换和皮肤机制，支持运行时动态更换主题。
•
启动与初始化：统一的主程序入口，处理异常、程序集加载、环境变量设置、命名管道通信等。
本章将详细介绍 UI 框架的架构设计、启动流程、页面和控件扩展方法，以及二次开发的最佳实践。
2.
UI 框架架构
2.1
分层架构
UI 框架采用分层设计，各层职责明确：
层次 | 说明 |
应用层 | 由业务页面组成，继承自 PageBase，实现具体业务逻辑。 |
页面层 | 提供页面容器、导航菜单、布局管理等功能，由 MainForm 和 PageBase 实现。 |
设计器层 | 提供运行时设计器页面（GuiStandard），支持拖拽控件、编辑属性、绑定 IO、保存布局。 |
控件层 | 包含基础控件（按钮、文本框等）和自定义控件，继承自 ControlBase。 |
核心层 | 提供属性系统、条件表达式、XML 序列化、事件总线等基础能力。 |
平台层 | 封装底层 API（IO 操作、日志、数据库等），供 UI 层调用。 |
2.2
核心组件关系
3.
启动与初始化
3.1
主程序入口
主程序入口位于 Program.cs，主要完成以下工作：
步骤 | 说明 |
1. 环境设置 | 调用 ControlHelper.LoadEnvPaths() 加载环境变量路径；初始化基础库 JSeqCon.JSeqCon_Initial("GUI_MAINFORM")；设置跨线程调用检查为 false。 |
2. 程序集解析 | 通过 AssemblyResolve 事件动态加载缺失的程序集，搜索路径包括 J:\JKBase\Gui、J:\JKBase\Library、J:\JKBase\Driver 及其子目录。 |
3. 异常处理 | 捕获未处理异常（UnhandledException），记录日志并尝试重启界面。 |
4. 启动模式判断 | 根据命令行参数决定是否自动启动（IsAutoStartup）。 |
5. 主窗体创建 | 创建 MainForm 实例，调用 ReadConfigFile 解析导航配置文件，添加消息过滤器，运行消息循环。 |
代码示例（简化）：
代码块
static void Main(string[] args)
{
Application.EnableVisualStyles();
Application.SetCompatibleTextRenderingDefault(true);
AppDomain.CurrentDomain.UnhandledException += CurrentDomain_UnhandledException;
AppDomain.CurrentDomain.AssemblyResolve += OnAssemblyResolve;
// 加载环境变量
MainTool.ControlHelper.LoadEnvPaths();
JSeqCon.JSeqCon_Initial("GUI_MAINFORM");
Control.CheckForIllegalCrossThreadCalls = false;
// 创建主窗体
MainForm.MAIN_GUI = new MainForm();
MainForm.MAIN_GUI.ReadConfigFile();
// 添加操作日志
JDB.JDB_Add_OpLog(MainForm.MAIN_GUI.Name, "Startup MainForm");
// 运行
Application.Run(MainForm.MAIN_GUI);
}