深入解析Terminal.Gui的UI Catalog项目-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00423/article/details/148416240

深入解析Terminal.Gui的UI Catalog项目

Terminal.Gui 项目地址: https://gitcode.com/gh_mirrors/gu/gui.cs

什么是Terminal.Gui和UI Catalog

Terminal.Gui是一个用于构建控制台用户界面的.NET库，它允许开发者在终端环境中创建丰富的GUI应用程序。而UI Catalog则是Terminal.Gui的官方示例库，它系统地展示了Terminal.Gui的各种功能和用法。

UI Catalog的设计目标

UI Catalog项目有三个核心设计目标：

功能展示：作为Terminal.Gui概念和功能的展示平台
代码示例：提供正确实现这些概念和功能的示例代码
贡献友好：使贡献者能够以结构化方式轻松添加新示例

为什么需要UI Catalog

早期的Terminal.Gui仅有一个简单的demo.cs示例文件，存在几个明显问题：

功能展示不够系统全面
缺乏对概念的详细解释
单一文件结构导致多人协作困难

UI Catalog正是为了解决这些问题而设计的现代化示例系统。

UI Catalog的核心架构

UI Catalog采用了一种灵活的架构设计：

主程序：Program.cs作为入口，提供场景选择界面
场景系统：每个功能示例都是一个继承自Scenario类的独立场景
反射机制：动态加载和组织所有场景

如何使用UI Catalog

基本使用方式

可以通过以下方式运行UI Catalog：

在项目目录下执行dotnet run命令
使用Visual Studio打开解决方案并运行

场景运行方式

UI Catalog提供了两种运行场景的方式：

交互式选择：通过主界面选择并运行场景
命令行直接运行：通过命令行参数指定场景名称

例如：UICatalog.exe Buttons将直接运行按钮示例场景。

开发新场景的完整指南

场景创建步骤

创建场景文件：在Scenarios目录下新建.cs文件
继承基类：从Scenario类派生新场景类
添加元数据：使用[ScenarioMetaData]属性设置名称和描述
分类标记：使用[ScenarioCategory]属性进行分类
实现Setup方法：编写场景的核心逻辑

基础场景示例

using Terminal.Gui;

namespace UICatalog {
    [ScenarioMetadata(Name: "按钮示例", Description: "展示Terminal.Gui中按钮的基本用法")]
    [ScenarioCategory("控件")]
    class ButtonDemo : Scenario {
        public override void Setup() {
            Win.Add(new Button() {
                Text = "点击我!", 
                X = Pos.Center(),
                Y = Pos.Center(),
                Clicked = () => MessageBox.Query(20, 7, "提示", "操作成功?", "是", "否")
            });
        }
    }
}