UI 组件目录
这页是“按任务找源码”的索引。运行时发现机制看 UI 运行时组件,DLL 边界看 UI DLL 速查,具体模块细节看对应 DLL 页。
快速定位
| 你要改什么 | 先看源码 | 所属页 |
|---|---|---|
| MVVM、命令、共享接口 | UI/ColorVision.Common/ | ColorVision.Common |
| 菜单、热键、状态栏、搜索 | UI/ColorVision.UI/ | ColorVision.UI |
| 功能搜索窗口、结果排序、执行目标 | UI/ColorVision.UI/Search/ | 产品搜索;宿主入口由 ColorVision/MainWindow.Hotkeys.cs 装配 |
| 设置窗口、市场、下载、向导 | UI/ColorVision.UI.Desktop/ | 桌面总览、设置、向导 |
| 主题、窗口外观、通用控件 | UI/ColorVision.Themes/ | ColorVision.Themes |
| PropertyGrid 和自定义编辑器 | UI/ColorVision.UI/PropertyEditor/ | PropertyGrid 契约 |
| 图像打开、工具栏、overlay | UI/ColorVision.ImageEditor/ | ColorVision.ImageEditor |
| 数据库连接和通用查询 | UI/ColorVision.Database/ | ColorVision.Database |
| Socket 管理和状态栏 | UI/ColorVision.SocketProtocol/ | ColorVision.SocketProtocol |
| Quartz 调度窗口 | UI/ColorVision.Scheduler/ | ColorVision.Scheduler |
| 工作区与项目树 | UI/ColorVision.Solution/ | 资源打开与切换 |
| 编辑器、文档与布局 | UI/ColorVision.Solution/Editor/、Workspace/ | 文档生命周期 |
| 终端与脚本 | UI/ColorVision.Solution/Terminal/ | 终端契约 |
| 多图查看、缩略图、景深融合 | UI/ColorVision.ImageTools/ | ColorVision.ImageTools |
| 登录、用户、角色、权限、会话 | UI/ColorVision.Rbac/ | RBAC 模块 |
扩展点
| 能力 | 接口/入口 | 备注 |
|---|---|---|
| 启动初始化 | IInitializer、InitializerBase | 放共享启动扩展,不放业务流程 |
| 主窗口初始化后扩展 | IMainWindowInitialized | MainWindow.LoadIMainWindowInitialized 在基础界面装配后按 Order 调用;具体服务是否就绪由初始化器负责 |
| 配置对象 | IConfig、ConfigService | 需要持久化的配置优先走这里 |
| 菜单 | IMenuItem、IMenuItemProvider、MenuItemBase、MenuItemAttribute | 发现、父子树、隐藏与执行;不将快捷键显示当成注册 |
| 状态栏 | IStatusBarProvider、IStatusBarProviderUpdatable、IActiveDocumentStatusProvider | 发现、绑定、文档通知与清理;隐藏不停止业务 |
| 界面语言 | LanguageConfig、LanguageManager、LanguagePropertiesEditor | 资源发现、文化回退和重启切换;不是全窗口实时翻译 |
| 热键 | IHotkeyProvider、IHotKey、HotkeyService | 定义身份、草稿、注册和释放;保存配置不证明注册成功 |
| 搜索候选 | ISearch、ISearchMetadata、ISearchProvider、IDynamicSearchProvider、IAsyncSearchProvider | 稳定身份、元数据、取消和执行边界;异步接口不允许后台访问 WPF 状态,不是仓库知识检索 |
| 当前内容查找 | ContextualFindRouter、ApplicationCommands.Find、LocalFindCommand | 功能搜索与局部查找的分流;优先尊重当前内容的查找入口 |
| 设置页与设置搜索 | IConfigSettingProvider、[ConfigSetting]、SettingSearchProvider、SettingWindow.NavigateToSetting | 发现缓存、共享条目目录、定位与活对象编辑;索引不实例化页面 |
| 属性编辑器 | PropertyEditorTypeAttribute、IPropertyEditor.GenProperties、PropertyEditorRegistry | 选择、复用与失败契约,不要在缓存编辑器实例里持有目标对象 |
| 图像打开器 | IImageOpen、FileExtensionAttribute | 新格式优先走打开器 |
| 图像工具 | IEditorTool、IEditorToggleTool、IEditorCustomControlTool | 工具由 ImageEditor 工厂装配 |
| 图像右键菜单 | IDVContextMenu、IIEditorToolContextMenu | 前者按 ContextType 为匹配图元提供 MenuItem,后者为标准菜单提供元数据;两者均可注入上下文,构造规则见图像编辑器上下文 |
| Solution 编辑器 | IEditor、EditorForExtensionAttribute | 新文件类型不要硬写在文件树里 |
| 向导步骤 | IWizardStep、IWizardInitializer | 步骤应用、初始化时序和完成标记 |
常用窗口
| 目标 | 入口 |
|---|---|
| 设置 | UI/ColorVision.UI.Desktop/Settings/SettingWindow.xaml |
| 功能搜索窗口 | UI/ColorVision.UI/Search/SearchWindow.xaml 为标准非模态 Owner 窗口,承载同目录 SearchControl.xaml;可拖动缩放,不单独显示任务栏项 |
| 插件市场 | UI/ColorVision.UI.Desktop/Marketplace/MarketplaceWindow.xaml |
| 下载器 | UI/ColorVision.UI.Desktop/Download/DownloadWindow.xaml |
| 日志 | UI/ColorVision.UI/LogImp/WindowLog.xaml |
| PropertyGrid | UI/ColorVision.UI/PropertyEditor/PropertyEditorWindow.xaml |
| 实体通用查询 | UI/ColorVision.Database/GenericQueryWindow.xaml |
| Socket 管理 | UI/ColorVision.SocketProtocol/SocketManagerWindow.xaml |
| 调度任务 | UI/ColorVision.Scheduler/TaskViewerWindow.xaml |
| 图像编辑器 | UI/ColorVision.ImageEditor/ImageView.xaml |
| 图形/ROI 编辑 | UI/ColorVision.ImageEditor/EditorTools/GraphicEditing/GraphicEditingWindow.xaml |
| 3D / CIE | UI/ColorVision.ImageEditor/EditorTools/ThreeD/、UI/ColorVision.ImageEditor/Cie/ |
| Solution 文件树 | UI/ColorVision.Solution/TreeViewControl.xaml |
| Solution 终端 | UI/ColorVision.Solution/Terminal/TerminalControl.xaml |
| RBAC | UI/ColorVision.Rbac/RbacManagerWindow.xaml |
落点规则
| 新能力 | 建议落点 | 避免 |
|---|---|---|
| 共享接口、命令、ViewModel | ColorVision.Common | 引用高层窗口或项目包 |
| 壳层菜单、状态栏、热键、搜索 | ColorVision.UI | 写客户业务 |
| 通用视觉控件或主题资源 | ColorVision.Themes | 依赖插件或 Engine |
| 图像工具、图元、overlay | ColorVision.ImageEditor | 做项目字段导出 |
| 实体查询窗口 | ColorVision.Database | 为每个业务窗口重复写条件查询 |
| Socket 管理基础设施 | ColorVision.SocketProtocol | 写具体项目测试流程 |
| 调度窗口和 Job 管理 | ColorVision.Scheduler | 把长耗时算法写进窗口 |
| 工作区、编辑器、终端 | ColorVision.Solution | 写设备控制主链路 |
| 多图查看和融合工具 | ColorVision.ImageTools | 把工具实现放回工作区壳层 |
| 用户、角色和权限管理 | ColorVision.Rbac | 把账户数据或细权限实现放进 Common |
| 市场、下载、向导、诊断 | ColorVision.UI.Desktop | 当作主程序入口 |
