从即时模式 GUI (IMGUI) 迁移到 UI 工具包

本指南适用于具有从即时模式 GUI (IMGUI) 迁移至__ UI__（即用户界面，User Interface）让用户能够与您的应用程序进行交互。Unity 目前支持三种 UI 系统。更多信息
See in Glossary 工具包经验的开发人员。本指南侧重于编辑器 UI，但其信息也适用于运行时 UI。

主要差异

代码驱动与 UI 驱动

IMGUI 由实现它的 C# 脚本中的 OnGUI 函数调用进行代码驱动。UI 工具包为编辑器 UI 创建提供了更多选项。使用 UI 工具包可以在 C# 脚本中定义行为。但是，在定义 UI 元素和样式时，除了 C# 之外，还可以在 UI Builder 中直观定义 UI 控件，或直接写入 XML 类文本文件（称为 UXML）。有关更多信息，请参阅 UI 工具包入门。

立即与保留模式

使用 IMGUI，可以在 OnGUI() 函数中重绘 UI 时描述 UI 树。当事件进入 UI 或重绘 UI 时，必须调用此函数。在不同事件之间没有与 UI 树相关的持久性信息。然而，您可以使用 UI 工具包在名为视觉树 (Visual Tree) 的树结构中创建视觉元素。视觉树中的信息将永久保留。

常量与状态变化

IMGUI 基于 OnGUI()function that runs at least once every frame. You define the look and the behaviors of the UI for every possible frame. The body ofOnGUI()`，可能包含许多条件和不同的状态。

UI 工具包在事件驱动的系统中运行。您可以定义处于默认状态的 UI 的外观，并定义 UI 响应事件的行为。在 UI 工具包中所做的任何更改都会导致 UI 状态的持续更改。

例如，IMGUI 中的按钮声明如下所示：

if (GUILayout.Button("Click me!"))
{
    //Code runs here in frames where the user clicks the button.

    //Code makes changes to the UI for frames where the user has just clicked the button.
}
else
{
    //Code specifies what happens in all other frames.
}

上方示例在 UI 工具包中如下所示：

UIDocument document = GetComponent<UIDocument>();

//Create button.
Button button = new Button();
button.text = "Click me!";

//Set up event handler.
button.RegisterCallback<ClickEvent>((ClickEvent evt) =>
{
    //Code runs here after button receives ClickEvent.
});

//Add button to UI.
document.rootVisualElement.Add(button);

有关如何使用 UI 工具包创建自定义编辑器窗口的完整示例，请参阅 UI 工具包入门。

IMGUI 支持

使用 IMGUIContainer 可将 IMGUI 代码放在 VisualElement 中。通常可在 OnGUI() 中执行的所有操作都受支持。

可以通过混合 GUILayout 和 UI 工具包布局来安排多个 IMGUIContainer 并排列它们。请注意，无法在 IMGUIContainer 中添加 VisualElement 实例。

从 IMGUI 转换到 UI 工具包

下表列出了 IMGUI 和 UI 工具包之间的等效函数：

下表列出了 IMGUI 和 UI 工具包之间的等效方法、类和属性：

其他资源

• UI 工具包入门
• Unity 样式表 (USS)
• 示例
• IMGUI 事件