Terminal.Gui 终端图形界面开发框架全面解析

翟舟琴Jacob

于 2025-06-04 09:04:40 发布

阅读量246

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00329/article/details/148416250

Terminal.Gui 终端图形界面开发框架全面解析

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

前言

在当今以图形界面为主流的应用开发领域，终端文本用户界面(TUI)仍然在服务器管理、开发工具、系统监控等场景中发挥着重要作用。Terminal.Gui 正是一个为.NET开发者打造的强大TUI开发框架，它让开发者能够轻松构建跨平台的终端应用程序。

框架概述

Terminal.Gui 是一个基于.NET的终端用户界面工具包，支持Windows、Mac和Linux/Unix系统。它提供了丰富的UI组件和灵活的布局系统，让开发者能够构建功能完善的终端应用程序。

核心特性

跨平台支持

支持Windows、Mac和Linux/Unix三大平台
提供多种终端驱动实现，包括Curses、Windows控制台和.NET控制台
完美兼容彩色和单色终端
支持SSH远程连接使用

开发体验

提供项目模板，可通过命令行工具快速创建项目
完善的键盘和鼠标输入处理
内置事件驱动API简化开发

UI系统

基于View的组件化架构，所有UI元素都是View的子类
提供数十种内置视图组件
强大的布局引擎支持相对布局和动态UI
支持剪贴板操作

高级功能

多任务处理支持，包括事件处理、空闲处理和定时器
线程安全设计
支持响应式扩展(Reactive Extensions)和MVVM模式

快速入门

最简单的示例

以下代码展示了一个最简单的Terminal.Gui应用程序：

using Terminal.Gui;
Application.Init();
var n = MessageBox.Query(50, 5, "Question", "Do you like TUI apps?", "Yes", "No");
Application.Shutdown();
return n;

这段代码会显示一个简单的对话框，询问用户是否喜欢TUI应用，并根据用户选择返回不同的整数值。

基本UI构建

更复杂的界面可以通过组合各种View类来创建：

using Terminal.Gui;
Application.Init();

var label = new Label() {
    Title = "Hello World",
    X = Pos.Center(),
    Y = Pos.Center(),
    Height = 1,
};

var app = new Toplevel();
app.Add(label);
Application.Run(app);
app.Dispose();
Application.Shutdown();

带菜单的应用程序

下面是一个包含菜单栏和按钮的完整示例：

using Terminal.Gui;

Application.Init();
var menu = new MenuBar(new MenuBarItem[] {
    new MenuBarItem("_File", new MenuItem[] {
        new MenuItem("_Quit", "", () => { 
            Application.RequestStop(); 
        })
    }),
});

var button = new Button() {
    Title = "_Hello",
    X = 0,
    Y = Pos.Bottom(menu),
    Width = Dim.Fill(),
    Height = Dim.Fill() - 1
};
button.Clicked += () => {
    MessageBox.Query(50, 5, "Hi", "Hello World! This is a message box", "Ok");
};

var app = new Toplevel();
top.Add(menu, button);
Application.Run(top);
top.Dispose();
Application.Shutdown();

核心概念详解

视图(View)系统

Terminal.Gui中的所有可见元素都是View类的实例。View是自包含的对象，负责自身的显示、处理键盘鼠标输入以及参与焦点机制。

每个View都可以包含任意数量的子视图(SubViews)，通过View.Add方法添加：

void SetupMyView(View myView)
{
    var label = new Label() {
        Title = "_Username:"
        X = 1,
        Y = 1,
        Width = 20,
        Height = 1
    };
    myView.Add(label);

    var username = new TextField() {
        X = Pos.Right(label) + 1,
        Y = 2,
        Width = 30,
        Height = 1
    };
    myView.Add(username);
}

模态视图

视图可以分为模态和非模态两种类型。模态视图会接管所有用户输入，直到用户关闭该视图。常见的模态视图包括Toplevel、Dialog和Wizard。

要将视图设置为模态，只需将其Modal属性设为true。使用Application.Run方法以模态方式运行视图，使用Application.RequestStop()终止模态执行。

bool okpressed = false;
var ok = new Button(3, 14, "Ok") { 
    Clicked = () => { Application.RequestStop(); okpressed = true; }
};
var cancel = new Button(10, 14, "Cancel") {
    Clicked = () => Application.RequestStop() 
};
var dialog = new Dialog("Login", 60, 18, ok, cancel);

var entry = new TextField() {
    X = 1, 
    Y = 1,
    Width = Dim.Fill(),
    Height = 1
};
dialog.Add(entry);
Application.Run(dialog);
if(okpressed)
    Console.WriteLine("The user entered: " + entry.Text);
dialog.Dispose();

窗口(Window)组件

Window是一种用于"重叠"布局的视图，提供边框和标题，可以通过键盘或鼠标移动和调整大小。

对话框(Dialog)组件

Dialog是模态的Window，通常显示在屏幕中央，用于获取用户输入或确认。

bool okpressed = false;
var ok = new Button() { Title = "Ok" };
var cancel = new Button() { Title = "Cancel" };
var dialog = new Dialog() { Text = "Are you sure you want to quit?", Title = "Quit", Buttons = { ok, cancel } };