创建具有两个属性的自定义控件

版本: 2023.2+

此示例演示如何创建具有两个属性的简单自定义控件。

示例概述

此示例创建一个名为MyElement的自定义控件，它具有两个属性，并将其公开到 UXML 和UI(用户界面) 允许用户与您的应用程序交互。Unity 目前支持三种 UI 系统。 更多信息
参见 词汇表 Builder。此示例还演示了如何在 UI Builder 中将自定义控件添加到 UI。

您可以在此 GitHub 存储库 中找到此示例创建的完整文件。

先决条件

本指南适用于熟悉 Unity、UI 工具包和 C# 脚本的开发者。在开始之前，请熟悉以下内容：

• UXML
• UI Builder

创建示例

要使用 C# 创建新的自定义控件类，请将其从VisualElement类继承。这允许您在 C# 中创建和使用此元素，但不会自动将其公开到 UXML 和 UI Builder 中。要将其公开，请添加UxmlElement 属性。要公开属性，请将UxmlAttribute 属性添加到您希望在 UXML 和 UI Builder 中可见的每个属性。

1. 使用任何模板创建一个 Unity 项目。
2. 在Assets文件夹中，创建一个名为MyElement.cs的 C# 脚本，内容如下：

using UnityEngine.UIElements;

[UxmlElement]
partial class MyElement : VisualElement
{
    [UxmlAttribute]
    public string myString { get; set; } = "default_value";

    [UxmlAttribute]
    public int myInt { get; set; } = 2;
}

创建 UXML 以查看属性

1. 创建一个您想要的任何名称的 UXML 文件。
2. 双击 UXML 文件在 UI Builder 中打开它。
3. 在 UI Builder 的库部分，选择项目>自定义控件 (C#)>MyElement。
4. 将MyElement拖动到层次结构窗口。
5. 要查看MyElement的自定义属性，请转到检查器一个 Unity 窗口，显示有关当前选定游戏对象、资产或项目设置的信息，允许您检查和编辑值。 更多信息
   参见 词汇表选项卡MyElement

其他资源

• 创建自定义控件