Terminal.Gui 术语体系与分类学指南:Arrangement、Layout、Navigation、Drawing、Scrolling 等核心概念全景解析
Terminal.Gui 术语体系与分类学指南:Arrangement、Layout、Navigation、Drawing、Scrolling 等核心概念全景解析
本文以 lexicon.md 及其七个分主题术语表为核心骨架,系统讲解 Terminal.Gui 中与视图排布(Arrangement)、配置(Configuration)、绘制(Drawing)、事件与命令(Events)、布局坐标系(Layout)、焦点导航(Navigation)和滚动(Scrolling)相关的全部核心术语,并结合当前仓库源码(
ViewArrangement、CommandRouting、ViewportSettingsFlags、VisualRole、Application等枚举与类)给出实现级佐证。读完本文,你将能准确使用 Terminal.Gui 的官方术语进行设计讨论、阅读源码文档与 API 注释,并能在自己的应用中正确配置布局、导航、滚动与绘制语义。
Terminal.Gui 是一个面向 .NET 的跨平台终端 UI 工具包,其 API 与文档中使用了大量精确定义的术语。为了统一沟通语言,项目在 docfx/docs/lexicon.md 中维护了一份「术语与分类学」(Lexicon & Taxonomy)文档,通过七个 include 文件把术语按主题归类。这些术语表不仅是阅读 docs 下各篇 Deep Dive 文档的敲门砖,也直接对应着源码中的枚举、类与属性——例如「Movable / Resizable」对应 ViewArrangement 枚举的标志位,「BubblingUp / DispatchingDown / Bridged」对应 CommandRouting 枚举,「Viewport」对应 View.Viewport 属性。本文按七个主题逐一展开,每个术语都给出含义、来源与源码印证。
一、Arrangement:视图排布与交互模式
Arrangement(排布)是 Layout 的一个特性,它控制用户能否通过鼠标和键盘对视图进行移动、缩放,并决定应用采用 Tiled(平铺)还是 Overlapped(重叠)布局。这一节是理解「用户如何操纵界面」的基础。
1.1 核心术语表
| 术语 | 含义 |
|---|---|
| Arrange Mode | 交互模式,通过 Ctrl+F5 激活(可在 Application.DefaultKeyBindings 中为 Command.Arrange 重新配置)。激活后会在可排布视图上显示指示器,并允许用户用键盘进行排布操作。 |
| Arrangement | Layout 的一项特性,控制用户如何用鼠标和键盘排布视图,并启用 Tiled 或 Overlapped 两种布局。 |
| Modal | 以“应用程序”方式通过 Application.Run 运行的视图,要求 Modal == true。具有受限的 Z-order,模态视图位于 z-order 1。 |
| Movable | 用户可通过键盘或鼠标移动的视图,通过设置 ViewArrangement.Movable 标志启用。 |
| Overlapped | SubViews 的 Frame 相互重叠的布局,Z-order 决定视觉堆叠顺序,通过 ViewArrangement.Overlapped 标志启用。 |
| Resizable | 用户可通过键盘或鼠标调整大小的视图,通过设置 ViewArrangement.Resizable 标志启用。 |
| Runnable | 调用了 Application.Run(Toplevel) 的视图。每个非模态 Runnable 视图都拥有自己的 RunState,作为一个自包含的应用程序运行。 |
| Tiled | SubViews 通常不重叠、无 Z-order 的布局,默认布局模式对应 ViewArrangement.Fixed。 |
1.2 ViewArrangement 枚举:源码级详解
术语表只是概念入口,真正的行为定义在 ViewArrangement.cs 的 [Flags] 枚举中。它描述了用户可以在 View.SuperView 内对视图执行的排布操作:
Fixed = 0:既不能移动也不能缩放;Movable = 1:可移动;LeftResizable = 2/RightResizable = 4:左/右边缘可缩放;TopResizable = 8/BottomResizable = 16:上/下边缘可缩放;Resizable:四方向均可缩放(LeftResizable | RightResizable | TopResizable | BottomResizable);Overlapped:启用重叠布局(视图帧允许相互重叠,由 Z-order 决定视觉层级);Tiled:平铺布局标志。
源码注释同时给出了两个重要约束(ViewArrangement.cs):
- 移动/缩放的前提:视图必须是某个
SuperView的子视图,且其位置与尺寸必须独立于其他 SubViews; - 互斥规则:
TopResizable与Movable互斥——若同时设置,Movable优先,此时上边缘不再可缩放。
1.3 Arrange Mode 交互模式
Arrange Mode 是排布能力的用户入口。术语表中标注其默认快捷键为 Ctrl+F5,且可在 Application.DefaultKeyBindings 中为 Command.Arrange 重新绑定。从源码看,Application.DefaultKeyBindings 是一个 Dictionary<Command, PlatformKeyBinding>,支持整体替换、单条 SetDefaultKeyBinding / RemoveDefaultKeyBinding,任何改动都会触发 DefaultKeyBindingsChanged 事件(Application.cs),ApplicationKeyboard 会订阅该事件并即时刷新绑定(ApplicationKeyboard.cs)。这意味着你可以在运行时动态替换 Arrange 模式的快捷键,无需重启应用。
1.4 Modal 与 Runnable:两种“应用级”视图
- Modal:以
Modal == true运行,z-order 被限制为 1,用户无法通过 Tab 焦点链或鼠标离开该视图,常用于对话框、确认框等需要阻断交互的场景; - Runnable:任何通过
Application.Run(Toplevel)启动的视图。非模态 Runnable 视图各自拥有独立的RunState,可以叠加运行(例如在主窗口之上再运行一个非模态面板)。
二、Configuration:配置系统
Terminal.Gui v2 的配置系统围绕 Microsoft.Extensions.Configuration(MEC)构建。术语表定义了一组配套概念,帮助你理解「配置从哪里来、如何被应用、何时生效」。更完整的操作指南见 config.md 与 Configuration 目录 下的源码。
2.1 核心术语表
| 术语 | 含义 |
|---|---|
| TuiConfigurationBuilder | 构建 Microsoft.Extensions.Configuration 的配置源链,并将设置应用到静态外观(static facades)。 |
| Settings POCO | 嵌套 JSON 分节的绑定目标(ButtonSettings、GlyphSettings、ApplicationSettings 等)。 |
| Theme-scoped settings | 不可变的 *Settings record,主题切换时通过 Current 属性整体替换(ButtonSettings、GlyphSettings 等)。 |
| Process-wide settings | 可变的 *Settings.Defaults,在应用配置时绑定一次(ApplicationSettings、DriverSettings、KeySettings、TraceSettings 等)。 |
| Theme | 位于 Themes:{name} 下的命名覆盖层,按属性级(property-level)合并到根分节。 |
| ThemeChanges | 面向无法注入 IThemeManager 的视图的进程级 ThemeChanged 观察器。 |
| Sources | MEC 提供程序链:硬编码 POCO 默认值、库自带 config.json、应用 config.json、~/.tui 与 ./.tui 文件、TUI_CONFIG 环境变量、RuntimeConfig。 |
| RuntimeConfig | TuiConfigurationBuilder 上优先级最高的内存 JSON 字符串,仅支持嵌套 MEC 形状。 |
2.2 配置源链(Sources)
配置按优先级从低到高依次为:硬编码 POCO 默认值 → 库内 config.json → 应用 config.json → ~/.tui / ./.tui 文件 → TUI_CONFIG 环境变量 → RuntimeConfig。这意味着:
- 库级
config.json(仓库中的 Terminal.Gui/Resources/config.json)提供出厂默认; - 应用级
config.json可覆盖库默认; - 用户目录或应用目录的
.tui文件再覆盖一层; TUI_CONFIG与运行时内存配置拥有最高优先级,适合部署与测试场景。
2.3 Settings POCO 与主题作用域
*Settings 类型分为两类:
- Theme-scoped(如
ButtonSettings、GlyphSettings):不可变 record,保存在Themes:{name}分节下,主题切换时整体替换Current。这也是「换肤」的底层机制——切换主题实际上是切换一套完整的、按属性合并过的设置快照; - Process-wide(如
ApplicationSettings、DriverSettings、KeySettings、TraceSettings):进程级单例,通过Defaults静态属性在 apply 阶段绑定一次,不随主题变化。
2.4 Theme 与 ThemeChanges
Theme 是 Themes:{name} 下的命名覆盖层,采用属性级合并(property-level merge)覆盖到根分节——即只覆盖显式声明的属性,其余继承根配置。而 ThemeChanges 是一个进程级观察器,为那些无法通过依赖注入拿到 IThemeManager 的视图提供主题切换通知,例如在 ThemeManager.cs 与 MecThemeManager.cs 中可以看到主题管理器的实现骨架。
三、Drawing:绘制体系
绘制体系回答「终端里一个像素级的字符如何被着色、如何体现语义」。核心是 Attribute、Scheme 与 VisualRole 三层:VisualRole 表达语义,Scheme 把语义映射到具体的 Attribute(前景色 + 背景色 + 样式),最终由驱动程序渲染为终端字符。
3.1 核心术语表
| 术语 | 含义 |
|---|---|
| Attribute | 为视觉元素定义具体视觉样式(前景色、背景色、TextStyle)。 |
| BackgroundColor | Attribute 中描述背景文字颜色的属性。 |
| Color | 基础终端颜色(支持 TrueColor 及 White、Black、Cyan 等命名值)。 |
| ForegroundColor | Attribute 中描述前景文字颜色的属性。 |
| Glyph | 字符的图形化表示。 |
| Rune | Unicode 字符。 |
| Scheme | 将 VisualRole 映射到 Attribute,基于语义目的定义视觉元素的外观(颜色与样式)。 |
| Style | Attribute 中用于字体类提示(粗体、斜体、下划线)的属性。 |
| VisualRole | 视觉元素的语义角色/用途(Normal、Focus、HotFocus、Active、Disabled、ReadOnly 等)。 |
3.2 Attribute 与 Color
Attribute 的核心由前景色、背景色与样式组成,其样式定义在 TextStyle.cs 的 TextStyle 枚举中(byte 类型,支持位组合)。颜色则支持命名色与 TrueColor,仓库中的 Color.cs 目录提供了完整的颜色模型、解析、格式化与量化实现。
3.3 Scheme 与 VisualRole:语义驱动配色
Scheme 是「语义 → 视觉」的桥梁:它把每个 VisualRole 映射到一个 Attribute。一个视图可以同时以多种角色渲染多个元素(例如聚焦的按钮同时有 Normal 底与 Focus 前景)。VisualRole.cs 中实际定义了远超术语表列举的角色,包括:
- 基础角色:
Normal、Focus、Active、Highlight、Disabled、Editable、ReadOnly; - 热键变体:
HotNormal、HotFocus、HotActive(带View.HotKey指示器的元素); - 代码高亮角色:
Code、CodeComment、CodeKeyword、CodeString、CodeNumber、CodeOperator、CodeType、CodePreprocessor、CodeIdentifier、CodeConstant、CodePunctuation、CodeFunctionName、CodeAttribute。
其中 Code 角色若未显式设置,会从 Editable 派生(调暗背景 + 粗体),用于 MarkdownCodeBlock 等预格式化内容。Scheme.cs 与 Schemes.cs 是这一映射的具体实现与预设集合。
3.4 Glyph 与 Rune
- Rune:Unicode 字符(一个码点);
- Glyph:字符的图形化表示。在终端环境中,一个“字形”可能由多个 Rune 组合而成(如框线字符、组合字符)。仓库中的 Glyphs.cs 定义了 LineCanvas 绘制所需的框线字形集合,GraphemeHelper.cs 则处理字形簇(grapheme cluster)层面的宽度与组合逻辑。
四、Events:事件、命令与路由
事件体系是 Terminal.Gui 交互模型的中枢。这一节不仅定义「事件、监听、触发」等基础概念,还引入了 v2 的命令系统(Command)与其四种路由方向。深度阅读见 command.md 与 cancellable-work-pattern.md。
4.1 基础概念
| 术语 | 含义 |
|---|---|
| Action | 表示可带参数调用但无返回值的委托类型,用于 Terminal.Gui 中的简单回调。 |
| Event | 对象间通信的通知机制,Terminal.Gui 广泛使用事件处理 UI 交互。 |
| Invoke | 触发事件、动作或方法的行为。 |
| Listen | 订阅/注册事件以接收通知的行为。 |
| Raise | 触发事件,通知所有已注册的事件处理程序。 |
| Handle/Handling/Handled | 适用于事件可被监听器(或 override)处理或不被处理的场景,例如鼠标移动、按键等源自用户操作的事件。 |
4.2 Command 与四种路由方向
Command 是一种把「请求」封装为对象的模式,支持参数化与排队。命令在视图层级中的传播方向由 CommandRouting.cs 枚举精确描述:
| 路由 | 含义 | 源码枚举值 |
|---|---|---|
| Direct | 直接调用(编程式调用,或来自视图自身绑定)。 | Direct |
| Bubble/Bubbling | 命令从 SubView 向 SuperView 向上传播(CommandsToBubbleUp 选项启用)。向上永远是 "bubble",绝不称为 "dispatch"。 |
BubblingUp |
| Dispatch/Dispatching | 命令从 SuperView 向特定 SubView 向下发送。向下永远是 "dispatch",绝不称为 "bubble"。DispatchDown 发送时抑制冒泡;TryDispatchToTarget 通过 GetDispatchTarget 与 ConsumeDispatch 为复合视图自动化派发。 |
DispatchingDown |
| Bridge/Bridging | 命令跨非包含边界路由(如 MenuBarItem ↔ PopoverMenu)。CommandBridge 订阅远端视图的完成事件,并以 CommandRouting.Bridged 在所有者上重新触发。 |
Bridged |
该枚举取代了旧版临时性的 IsBubblingUp / IsBubblingDown 布尔标志(见 CommandRouting.cs 注释),路由信息携带在 ICommandContext.Routing 上。
4.3 可取消工作模式(Cancellable Work Pattern)中的相关术语
- Cancel/Cancelling/Cancelled:适用于可被取消的场景,例如更改
Slider的Orientation是可取消的; - Cancellation:通过事件参数中设置
Cancel/Handled属性、或从虚方法返回bool来中止阶段或工作流; - Context:传给观察者用于决策的数据,如
DrawContext(绘制)、Key(键盘)、ICommandContext(命令)、CancelEventArgs<Orientation>(方向); - Default Behavior:每个阶段的默认实现,如
DrawText(绘制)、InvokeCommands(键盘与应用级)、RaiseActivating(命令)、OrientationHelper(属性更新); - Notifications:每个阶段触发的事件(如
DrawingText、KeyDown、Activating、OrientationChanging)与对应的虚方法(OnDrawingText、OnKeyDown、OnActivating、OnOrientationChanging); - Workflow:可取消工作模式中的阶段序列——多阶段(如
View.Draw中的渲染)、线性(如View.Keyboard中的按键处理)、按单元(如View.Command中的命令执行)或事件驱动(如Application.Keyboard的按键处理、OrientationHelper的属性变更)。
五、Layout:布局与坐标系
布局术语是整个框架中最容易混淆的部分——同一个坐标可能相对于屏幕、应用、父视图、内容或视口。理解这五种坐标系是写出正确布局代码的前提。完整指南见 layout.md。
5.1 坐标系全景
| 坐标系 | 定义 |
|---|---|
| Screen-Relative | 底层终端的坐标。原点 (0,0) 位于终端左上角。所有 ConsoleDriver 实现仅在 Screen-Relative 坐标上工作。 |
| Application-Relative | 应用的坐标。由于目前仅支持全屏应用,Application 在布局意义上等同 Screen,Application.Top 左上角固定在 (0,0),大小为整个 Screen。 |
| Frame-Relative | View.Frame 属性是相对 SuperView 内容区的矩形。FrameToScreen / ScreenToFrame 是坐标转换辅助方法。 |
| Content-Relative | 视图内容区的坐标。内容原点恒为 (0,0),尺寸由 View.GetContentSize 定义。ContentToScreen / ScreenToContent 负责转换。 |
| Viewport-Relative | 用户可见的内容子集(View.Viewport)。坐标受 (0,0) 与 Padding 内矩形尺寸约束。View.Move 等绘制原语接受 Viewport-Relative 坐标。 |
5.2 相关核心术语
| 术语 | 含义 |
|---|---|
| Frame | 定义视图位置与尺寸的 Rectangle,坐标相对 SuperView(Application.Top 则相对控制台尺寸),由 View.X/Y/Width/Height 控制。 |
| Content Area | 视图的全部内容。位置恒为 (0,0),尺寸由 View.SetContentSize 设置,默认等于 Viewport 尺寸;内容大于 Viewport 时启用滚动。 |
| Viewport | 用户当前可见的内容区域。Content Area 大于 Viewport 时启用滚动,Viewport 的位置决定可见部分。 |
| Adornment | 定义 Frame 与 Viewport 之间间隔的轻量对象(IAdornment 实现),共有三种:Margin、Border、Padding,各自可通过 GetOrCreateView() 懒创建 AdornmentView 用于渲染与 SubView 支持。Adornment 不属于视图内容,不受 ClipArea 裁剪。 |
| Margin | 最外层的 Adornment,外侧与 Frame 同尺寸,默认 {0,0,0,0};加厚时视觉透明且默认对鼠标事件透明。 |
| Border | 位于 Margin 内侧。绘制视觉边框(框线字形)与 View.Title,并允许用户用鼠标/键盘调整视图的 Arrangement。 |
| Padding | 位于 Border 内侧、Viewport 外侧,默认 {0,0,0,0};不属于内容、不受 Clip 裁剪,启用后滚动条位于 Padding 内。 |
| Thickness | 智能 record struct,描述四边各有宽度的矩形,宽度合法值 >= 0。 |
| Overlapped/Overlapping | 子视图 Frame 相互重叠的布局形式,除 X/Y 维外还有 Z 轴(Z-order)。 |
| Tiled/Tiling | 子视图彼此紧贴、互不重叠的布局形式;仅当开发者故意让视图对齐重叠时 Z-order 才起作用。 |
5.3 Adornment 的实现位置
三种 Adornment 在 Adornment 目录 中都有独立实现:Margin.cs / MarginView.cs、Border.cs / BorderView.cs、Padding.cs / PaddingView.cs,以及接口定义 IAdornment.cs / IAdornmentView.cs 和用于交互排布的 Arranger.cs、ArrangeButtons.cs 等。想深入理解 Adornment 如何在布局与交互中起作用,可以从这些文件入手。
六、Navigation:焦点与键盘导航
导航术语描述焦点如何在视图层级中移动。核心模型是「焦点链」(Focus Chain)与「Tab 停止点」(TabStop)/「Tab 分组」(TabGroup)。深度阅读见 navigation.md 与 cursor.md。
6.1 核心术语表
| 术语 | 含义 |
|---|---|
| Cursor | 提示用户键盘输入将作用于何处的视觉指示器。每个终端会话只有一个 Cursor。 |
| Focus | 某个 UI 元素(View)被选中并准备接收输入的状态。 |
| Focus Chain | 可接收焦点的有序元素序列:从当前焦点元素向上延伸至其父(SuperView)元素,直到焦点树根(Application.Top)。整个应用只有一个焦点链拥有焦点(top.HasFocus == true),且一个焦点链中只有一个「最聚焦」的视图接收键盘输入。 |
| Enter / Gain | 视图从未聚焦变为聚焦(v1 遗留术语),“The View is entering focus” 即 “The View is gaining focus”。 |
| Leave / Lose | 视图从聚焦变为未聚焦(v1 遗留术语)。 |
| Focus Ordering | 可聚焦视图被导航的顺序,通常用于支持屏幕阅读器与提升可访问性。v1 中由 TabIndex/TabIndexes 提供。 |
| Navigation | 在应用视图层级中移动焦点的用户体验。 |
| TabGroup | 容纳其他可聚焦视图的容器 View,用于在视图层级中「向上/向下」导航。 |
| TabStop | 键盘导航的最终停止点——即没有可聚焦子视图的视图。导航只在同级(peer)视图之间进行。 |
| Tab | 既指键盘上的 Tab 键,也指比空格更宽的文本断点,还指键盘导航中的停止点 UI 元素。 |
6.2 TabGroup 与 TabStop 的默认键位:以源码为准
Application.DefaultKeyBindings 在 Application.cs 中注册了这些命令的默认键位:
[Command.NextTabStop] = Bind.All (Key.Tab),
[Command.PreviousTabStop] = Bind.All (Key.Tab.WithShift),
[Command.NextTabGroup] = Bind.All (Key.F6),
[Command.PreviousTabGroup] = Bind.All (Key.F6.WithShift),
即当前仓库源码中,Tab / Shift+Tab 用于在 TabStop(同级可聚焦视图)之间前后移动,F6 / Shift+F6 用于在 TabGroup(视图层级)之间前后移动。对应的导航实现位于 ApplicationKeyboard.cs:NextTabStop 调用 AdvanceFocus(NavigationDirection.Forward, TabBehavior.TabStop),NextTabGroup 调用 AdvanceFocus(NavigationDirection.Forward, TabBehavior.TabGroup)。注意:lexicon.md 中记载的默认键位为 Ctrl+PageDown / Ctrl+PageUp,而当前仓库实际注册值为 F6 / Shift+F6——以源码为准,且两者均可通过 Application.DefaultKeyBindings 在配置或运行时覆盖。
6.3 在应用中使用
由于焦点链、TabGroup、TabStop 全部基于视图层级自动推导,你通常只需把可交互控件放进容器视图,框架即可给出合理的默认导航;需要定制时,通过 Application.SetDefaultKeyBinding / RemoveDefaultKeyBinding 调整键位,或通过 Application.DefaultKeyBindings 属性整体替换绑定字典(Application.cs)。
七、Scrolling:滚动机制
滚动机制回答「内容大于视口时,用户如何查看与定位」。核心对象是 ScrollBar、ScrollSlider 与 ViewportSettings 标志位。完整指南见 scrolling.md 与 layout.md。
7.1 核心术语表
| 术语 | 含义 |
|---|---|
| Content Area | 可滚动的全部内容区域,由 View.GetContentSize 定义;大于 Viewport 时启用滚动。 |
| Scroll | 让内容在 View.Viewport 内水平或垂直移动的行为,也称 "Content Scrolling"。 |
| ScrollBar | 指示可滚动内容的规模并控制可见内容的位置(垂直或水平)。两端各有一个 Button(上/左、下/右),中间是可拖动的 ScrollSlider。Slider 的尺寸反映可滚动内容与 Viewport 的比例。 |
| ScrollSlider | 显示可滚动内容与 Viewport 大小比例的视觉指示器,支持鼠标拖动滚动。 |
| Viewport | 指向 Content Area(View.GetContentSize 返回值)的可滚动“视口”。 |
| ViewportSettings | 调整滚动行为的配置标志,包括是否允许负坐标、如何应用裁剪等。 |
7.2 ViewportSettingsFlags:标志位全景
ViewportSettingsFlags.cs 中的 [Flags] 枚举精确控制视口的边界行为,按功能可分为四组:
1. 允许负坐标(向内容之外滚动):
AllowNegativeX/AllowNegativeY:允许Viewport.X/.Y为负,即滚出内容左侧/顶部;AllowNegativeXWhenWidthGreaterThanContentWidth/AllowNegativeYWhenHeightGreaterThanContentHeight:当视口尺寸大于内容尺寸时允许负坐标,可用于无限滚动场景;AllowNegativeLocation/AllowNegativeLocationWhenSizeGreaterThanContentSize:对应的组合标志。
2. 允许超出内容尾部(右侧/底部出现空白):
AllowXGreaterThanContentWidth/AllowYGreaterThanContentHeight:允许Viewport位置超过ContentSize - 1;AllowXPlusWidthGreaterThanContentWidth/AllowYPlusHeightGreaterThanContentHeight:允许Viewport.X + Viewport.Width超过ContentSize.Width,滚动时右侧/底部可出现空白;- 对应组合标志
AllowLocationGreaterThanContentSize与AllowLocationPlusSizeGreaterThanContentSize。
3. 裁剪与清除:
ClipContentOnly:默认裁剪应用于 Viewport;设置后裁剪改为应用于可见内容区;ClearContentOnly:仅清除 Content Area 中 Viewport 可见部分(需同时设置ClipContentOnly才生效),适合内容大于视口且希望内容外区域视觉可区分的视图。
4. 透明与滚动条:
Transparent:视图透明——绘制时不清除 Viewport,裁剪区域改为裁剪视图的View.Text与 SubViews。注意只有 SubView 层级中最顶层的视图可透明,其子视图绘制行为不确定;TransparentMouse:对鼠标透明——发生在视图上但不被任何 SubView 占据的鼠标事件不会被该视图捕获。可与Transparent组合实现「视觉与鼠标双透明」;HasVerticalScrollBar/HasHorizontalScrollBar/HasScrollBars:启用内置垂直/水平滚动条(ScrollBarVisibilityMode.Auto行为);清除标志会禁用滚动条并将其VisibilityMode置为Manual且Visible = false。
结语
Terminal.Gui 的术语体系不是纸上谈兵——它直接映射到框架的公共 API:ViewArrangement 决定用户能否移动/缩放视图,CommandRouting 决定命令在视图层级中的传播方向,ViewportSettingsFlags 决定滚动边界,VisualRole 与 Scheme 决定绘制语义,Focus Chain / TabGroup / TabStop 决定键盘导航。当你阅读 docs 目录下的各篇 Deep Dive(layout.md、arrangement.md、command.md、scrolling.md、navigation.md 等)或浏览源码注释时,本文可作为一份随身术语表:遇到不理解的概念,回到 lexicon.md 对应的主题分节(arrangement、configuration、drawing、events、layout、navigation、scrolling)查证定义,再到本文指出的源码文件中确认行为,即可准确、高效地使用 Terminal.Gui 构建终端 UI 应用。