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

UI Toolkit 在事件驱动系统中运行。您可以定义 UI 在其默认状态下的外观，并在事件响应中定义 UI 的行为。在 UI Toolkit 中做出的任何更改都会对 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 Toolkit 中形式如下

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 Toolkit 创建自定义编辑器窗口的完整示例，请参阅 使用 UI Toolkit 入门。

IMGUI 支持

使用 IMGUIContainer 将 IMGUI 代码放在 VisualElement 内。OnGUI() 中能做的一切都得到支持。

您可以排列多个 IMGUIContainer 并通过混合使用 GUILayout 和 UI Toolkit 布局对其进行布局。请注意，不可能在 IMGUIContainer 中添加 VisualElement 实例。

从 IMGUI 到 UI Toolkit 转换

下表列出了 IMGUI 与 UI Toolkit 之间的等效函数

下表列出了 IMGUI 和 UI Toolkit 之间等效的方法、类和属性

Additional resources

• 开始使用 UI Toolkit
• Unity 样式表 (USS)
• 示例
• IMGUI 事件