Ghidra 用户界面框架提供了一个灵活的可停靠窗口系统，允许在应用程序中安排、选项卡显示、独立显示和管理 GUI 组件。本文档涵盖了核心 UI 架构、关键组件以及它们如何交互以创建 Ghidra 的自适应用户界面。有关基于此框架构建的特定编辑器的信息，请参阅数据类型编辑器。
Ghidra 的 UI 框架建立在可停靠窗口系统之上，该系统允许组件根据需要重新排列。其基础是一个组件提供者模型，其中 UI 元素通过组件和窗口的层次结构进行管理。
图表：核心 UI 框架组件
来源
DockingWindowManager 是管理 UI 组件的中心控制器。它处理组件可见性、焦点和组件间导航。Ghidra 中的每个工具都有自己的 DockingWindowManager 实例，用于管理与该工具关联的所有窗口和组件。
DockingWindowManager 的主要功能
来源: Ghidra/Framework/Docking/src/main/java/docking/DockingWindowManager.java63-1135
ComponentProvider 是一个抽象基类，用于在工具内创建可停靠的 GUI 组件。组件（例如，代码查看器、编辑器、图表）扩展此类别以与停靠系统集成。
ComponentProvider 类
图表：ComponentProvider 实现
来源
节点层次结构管理组件的可视化布局
来源: Ghidra/Framework/Docking/src/main/java/docking/RootNode.java39-215
ComponentPlaceholder 对象跟踪组件位置和状态信息。它们
来源
Ghidra 的 UI 组件通常遵循模型-视图-控制器 (MVC) 模式
图表：UI 组件中的 MVC 模式
来源
模型处理数据和业务逻辑。它们通知监听器更改并维护组件状态。示例：
StructureEditorModel: 管理结构体数据类型编辑UnionEditorModel: 处理联合体数据类型编辑CompositeEditorModel: 复合类型编辑器的基类CompositeViewerModel: 查看复合类型的基类视图负责通过面板、表格和其他用户界面组件向用户显示数据
CompositeEditorPanel: 复合编辑器的基本面板BitFieldEditorPanel: 用于编辑位域的特定面板CompEditorPanel: 具有附加功能的增强型编辑器面板操作和事件处理程序将用户交互连接到模型
CompositeEditorTableAction: 编辑器操作的基本操作UnpackageAction）可停靠窗口系统允许灵活的窗口布局
图表：窗口布局管理
来源
窗口系统提供
来源: Ghidra/Framework/Docking/src/main/java/docking/DockingWindowManager.java499-510
要在 Ghidra 中创建新的用户界面组件
ComponentProvidergetComponent()DockingWindowManager 注册您的组件创建组件时
// Required methods
public JComponent getComponent() - Returns the component to display
public String getTitle() - Returns component title
// Optional but common methods to override
public Icon getIcon() - Returns component icon
public HelpLocation getHelpLocation() - Returns help info
public ActionContext getActionContext() - Returns context for actions
public void componentShown/Hidden() - Handle visibility changes
来源: Ghidra/Framework/Docking/src/main/java/docking/ComponentProvider.java176
组件经历以下生命周期事件
| 事件 | 方法 | 描述 |
|---|---|---|
| 创建 | 构造函数 | 初始化组件和操作 |
| 注册 | addToTool() | 添加到工具的 DockingWindowManager |
| 显示中 | componentShown() | 组件变为可见 |
| 激活函数 | componentActivated() | 组件获得焦点 |
| 停用 | componentDeactived() | 组件失去焦点 |
| 隐藏中 | componentHidden() | 组件被隐藏 |
| 删除 | removeFromTool() | 组件从工具中移除 |
| 处置 | 工具处置 | 资源被释放 |
来源: Ghidra/Framework/Docking/src/main/java/docking/ComponentProvider.java436-487
组件可以具有相关联的操作，这些操作
图表：操作管理
来源
代码浏览器是 Ghidra 中最重要的用户界面组件之一
图表：代码浏览器组件
来源
结构体编辑器提供结构体数据类型的编辑功能
图表：结构体编辑器组件
来源
UI 框架自动保存和恢复窗口布局
来源
Ghidra 的用户界面框架提供了一个强大而灵活的系统，用于在应用程序中创建和管理用户界面组件。通过使用可停靠窗口系统，组件可以根据需要重新排列、选项卡显示和独立显示，允许用户根据个人偏好定制其工作空间。ComponentProvider 模型使得创建新的用户界面组件并将其与应用程序的其余部分无缝集成变得简单直观。