gui.cs 开源项目教程

2024-09-21 09:55:11作者：毕习沙Eudora

1. 项目介绍

gui.cs 是一个用于构建现代、跨平台终端用户界面（TUI）的 .NET 库。该项目最初由 Miguel de Icaza 在 2007 年为 mono-curses 编写，现在由 Tig Kindel 维护。gui.cs 提供了一套丰富的控件和工具，使开发者能够轻松创建功能强大的终端应用程序，支持 Windows、Mac 和 Linux/Unix 系统。

2. 项目快速启动

安装

首先，确保你已经安装了 .NET SDK。然后，使用以下命令安装 Terminal.Gui 模板：

dotnet new --install Terminal.Gui.Templates

创建新项目

使用以下命令创建一个新的 Terminal.Gui 项目：

dotnet new tui -n myproj
cd myproj

运行项目

进入项目目录后，运行以下命令启动应用程序：

dotnet run

示例代码

以下是一个简单的 Terminal.Gui 应用程序示例：

using Terminal.Gui;

Application.Run<ExampleWindow>();
Application.Shutdown();

public class ExampleWindow : Window
{
    public static string UserName;

    public ExampleWindow()
    {
        Title = $"Example App ({Application.QuitKey} to quit)";

        var usernameLabel = new Label { Text = "Username:" };
        var userNameText = new TextField
        {
            X = Pos.Right(usernameLabel) + 1,
            Width = Dim.Fill()
        };

        var passwordLabel = new Label
        {
            Text = "Password:",
            X = Pos.Left(usernameLabel),
            Y = Pos.Bottom(usernameLabel) + 1
        };

        var passwordText = new TextField
        {
            Secret = true,
            X = Pos.Left(userNameText),
            Y = Pos.Top(passwordLabel),
            Width = Dim.Fill()
        };

        var btnLogin = new Button
        {
            Text = "Login",
            Y = Pos.Bottom(passwordLabel) + 1,
            X = Pos.Center(),
            IsDefault = true
        };

        btnLogin.Clicked += (s, e) =>
        {
            if (userNameText.Text == "admin" && passwordText.Text == "password")
            {
                MessageBox.Query("Logging In", "Login Successful", "Ok");
                UserName = userNameText.Text;
                Application.RequestStop();
            }
            else
            {
                MessageBox.ErrorQuery("Logging In", "Incorrect username or password", "Ok");
            }
        };

        Add(usernameLabel, userNameText, passwordLabel, passwordText, btnLogin);
    }
}