ColorVision.UI 1.5.1.4

ColorVision.UI

版本: 1.5.1.1 | 目标框架: .NET 8.0 / .NET 10.0 Windows | UI框架: WPF

🎯 功能定位

ColorVision 系统的底层控件库和框架支持，提供丰富的 UI 组件、系统功能和基础设施。它是整个应用程序 UI 层的基础，包含配置系统、程序集管理、文件处理器工厂等核心功能。

作用范围

基础 UI 层，为所有上层模块提供统一的配置管理、程序集加载、文件处理等基础服务。

主要功能点

配置管理 (ConfigHandler)

• 配置中心 - 统一的配置管理和持久化
• 自动加载 - 应用程序启动时自动加载配置
• 变更通知 - 配置变更事件通知机制
• 多环境支持 - 支持开发、测试、生产环境配置

程序集管理 (AssemblyHandler)

• 动态加载 - 插件程序集的动态加载和卸载
• 类型发现 - 自动发现和注册类型
• 依赖管理 - 程序集依赖关系管理
• 版本控制 - 程序集版本兼容性检查

文件处理工厂 (FileProcessorFactory)

• 处理器注册 - 文件处理器的注册和管理
• 扩展名映射 - 根据文件扩展名自动选择处理器
• 工厂模式 - 统一的文件处理接口

显示管理 (DisPlayManager)

• 多显示器支持 - 检测和管理多个显示器
• 分辨率适配 - 自动适配不同分辨率
• DPI 感知 - 高 DPI 显示支持

环境管理 (Environments)

• 环境变量 - 应用程序环境变量管理
• 运行时信息 - 获取系统和运行时信息
• 路径管理 - 应用程序路径统一管理

技术架构

┌─────────────────────────────────────────────────────────────┐
│                      ColorVision.UI                           │
│                                                              │
│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐      │
│  │ ConfigHandler│   │AssemblyHandler│   │FileProcessor │     │
│  │             │    │             │    │   Factory    │      │
│  │ • 配置加载  │    │ • 插件加载  │    │ • 文件处理   │      │
│  │ • 配置保存  │    │ • 类型发现  │    │ • 处理器注册 │      │
│  │ • 变更通知  │    │ • 依赖管理  │    │ • 扩展名映射 │      │
│  └─────────────┘    └─────────────┘    └─────────────┘      │
│         │                   │                   │            │
│         └───────────────────┼───────────────────┘            │
│                             ▼                                │
│                    ┌─────────────────┐                       │
│                    │   上层 UI 模块   │                       │
│                    │ ColorVision.UI.* │                       │
│                    └─────────────────┘                       │
└─────────────────────────────────────────────────────────────┘

与主程序的依赖关系

被引用方式:

• ColorVision.UI.Desktop - 桌面应用程序入口
• ColorVision.Solution - 解决方案管理
• ColorVision.ImageEditor - 图像编辑器
• ColorVision.Database - 数据库模块
• 所有其他 UI 模块

引用的程序集:

• ColorVision.Common - 通用工具类
• 无其他 UI 层依赖（保持底层纯净）

使用方式

引用方式

<ProjectReference Include="..\ColorVision.UI\ColorVision.UI.csproj" />

基础使用示例

1. 配置管理初始化

// 应用程序启动时读取配置
ConfigHandler.GetInstance();

// 访问配置
var config = ConfigHandler.Instance;
var setting = config.GetSetting("Key");

// 保存配置
config.SetSetting("Key", "Value");
config.Save();

2. 程序集管理

// 加载插件程序集
AssemblyHandler.Instance.LoadAssembly("Plugin.dll");

// 获取已加载的类型
var types = AssemblyHandler.Instance.GetTypes()
    .Where(t => t.GetCustomAttribute<PluginAttribute>() != null);

// 创建实例
var plugin = AssemblyHandler.Instance.CreateInstance<IPlugin>(type);

3. 文件处理工厂

// 注册文件处理器
FileProcessorFactory.Instance.Register(".txt", typeof(TextFileProcessor));
FileProcessorFactory.Instance.Register(".csv", typeof(CsvFileProcessor));

// 获取处理器并处理文件
var processor = FileProcessorFactory.Instance.GetProcessor(".txt");
processor.Process(filePath);

4. 显示管理

// 获取主显示器信息
var primaryDisplay = DisPlayManager.Instance.GetPrimaryDisplay();
Console.WriteLine($"分辨率: {primaryDisplay.Width}x{primaryDisplay.Height}");
Console.WriteLine($"DPI: {primaryDisplay.DpiScale}");

// 获取所有显示器
var displays = DisPlayManager.Instance.GetAllDisplays();
foreach (var display in displays)
{
    Console.WriteLine($"显示器: {display.Name}, 位置: ({display.X}, {display.Y})");
}

5. 环境管理

// 获取应用程序路径
var appPath = Environments.AppPath;
var configPath = Environments.ConfigPath;
var dataPath = Environments.DataPath;

// 获取运行时信息
var version = Environments.AppVersion;
var framework = Environments.FrameworkVersion;
var osVersion = Environments.OSVersion;

主要组件

ConfigHandler

配置管理器的核心，负责应用程序配置的加载、保存和变更通知。

public class ConfigHandler
{
    public static ConfigHandler Instance { get; }
    
    public T GetSetting<T>(string key, T defaultValue = default);
    public void SetSetting<T>(string key, T value);
    public void Save();
    public void Load();
    
    public event EventHandler<ConfigChangedEventArgs> ConfigChanged;
}

AssemblyHandler

程序集管理器，负责插件的动态加载和类型发现。

public class AssemblyHandler
{
    public static AssemblyHandler Instance { get; }
    
    public void LoadAssembly(string assemblyPath);
    public void UnloadAssembly(string assemblyName);
    public IEnumerable<Type> GetTypes();
    public IEnumerable<Type> GetTypes<TInterface>();
    public T CreateInstance<T>(Type type);
    
    public event EventHandler<AssemblyLoadedEventArgs> AssemblyLoaded;
}

FileProcessorFactory

文件处理器工厂，实现文件扩展名到处理器的映射。

public class FileProcessorFactory
{
    public static FileProcessorFactory Instance { get; }
    
    public void Register(string extension, Type processorType);
    public void Unregister(string extension);
    public IFileProcessor GetProcessor(string extension);
    public IFileProcessor GetProcessor(string extension, string mimeType);
    
    public IEnumerable<string> SupportedExtensions { get; }
}

DisPlayManager

显示管理器，提供多显示器和 DPI 支持。

public class DisPlayManager
{
    public static DisPlayManager Instance { get; }
    
    public DisplayInfo GetPrimaryDisplay();
    public IEnumerable<DisplayInfo> GetAllDisplays();
    public DisplayInfo GetDisplayAt(int x, int y);
    
    public event EventHandler<DisplayChangedEventArgs> DisplayChanged;
}

public class DisplayInfo
{
    public string Name { get; }
    public int X { get; }
    public int Y { get; }
    public int Width { get; }
    public int Height { get; }
    public double DpiScale { get; }
    public bool IsPrimary { get; }
}

Environments

环境管理器，提供应用程序环境信息。

public static class Environments
{
    public static string AppPath { get; }
    public static string ConfigPath { get; }
    public static string DataPath { get; }
    public static string LogPath { get; }
    public static string TempPath { get; }
    
    public static Version AppVersion { get; }
    public static string FrameworkVersion { get; }
    public static string OSVersion { get; }
    public static bool Is64Bit { get; }
}

目录说明

• ConfigHandler.cs - 配置管理器
• AssemblyHandler.cs - 程序集管理器
• FileProcessorFactory.cs - 文件处理器工厂
• DisPlayManager.cs - 显示管理器
• Environments.cs - 环境管理

开发调试

# 构建项目
dotnet build UI/ColorVision.UI/ColorVision.UI.csproj

# 运行测试
dotnet test

最佳实践

1. 配置管理

• 使用强类型配置类包装 ConfigHandler
• 在应用启动时加载配置，退出时保存
• 订阅配置变更事件进行动态响应

2. 程序集加载

• 验证程序集签名后再加载
• 使用 AppDomain.AssemblyResolve 处理依赖
• 记录程序集加载日志便于排查问题

3. 文件处理

• 处理器实现应是无状态的
• 使用 Try-Catch 处理文件访问异常
• 大文件处理应使用异步模式

4. 显示管理

• 监听 DisplayChanged 事件响应显示器变化
• 使用 DPI 感知布局避免模糊
• 支持多显示器间的窗口拖拽

相关文档链接

• 详细技术文档
• 配置管理指南
• UI组件概览

更新日志

v1.5.1.1 (2025-02)

• 支持 .NET 10.0
• 优化配置加载性能

v1.4.1.1 (2025-02)

• 改进程序集加载机制
• 增加显示管理功能

v1.3.18.1 (2025-02)

• 优化文件处理器工厂
• 增加环境管理功能

维护者

ColorVision UI团队