Version: 2021.3
Write UXML Templates
UXML 元素参考

Load UXML from C# scripts

要根据 UXML 模板构建用户界面,必须先将模板加载到 VisualTreeAsset 中:

var template = EditorGUIUtility.Load("path/to/file.uxml") as VisualTreeAsset;

或者采用更直接的方式:

var template = AssetDatabase.LoadAssetAtPath<VisualTreeAsset>("path/to/file.uxml");

然后可以构建表示的视觉树并将其附加到父元素:

template.CloneTree(parentElement, slots);

在上面的语句中,模板中的 <UXML> 元素被转换为 VisualElement。相反,其所有子项都附加到 parentElement 指定的元素。

实例化模板后,即可使用 UQuery(Unity 的 JQuery/Linq 实现)从视觉元素树中检索特定元素。

例如,以下代码演示了如何创建新的 EditorWindow 并加载 UXML 文件作为其内容:


public class MyWindow : EditorWindow  {
    [MenuItem ("Window/My Window")]
    public static void  ShowWindow () {
        EditorWindow w = EditorWindow.GetWindow(typeof(MyWindow));

        VisualTreeAsset uiAsset = AssetDatabase.LoadAssetAtPath<VisualTreeAsset>("Assets/MyWindow.uxml");
        VisualElement ui = uiAsset.CloneTree(null);

        w.rootVisualElement.Add(ui);
    }

    void OnGUI () {
        // 此处无需执行任何操作,除非还需要处理 IMGUI 相关事项。
    }
}
Write UXML Templates
UXML 元素参考
Copyright © 2023 Unity Technologies
优美缔软件(上海)有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961