Version: 6000.3
语言: 中文
使用 Toggle 创建条件 UI
创建幻灯片切换自定义控件

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

版本: 2023.2+

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

示例概述

此示例创建名为MyElement具有两个属性,并将其公开给 UXML 和 UI Builder。此示例还演示如何将自定义控件添加到 UI 生成器中的 UI。

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

先决条件

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

创建示例

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

  1. 使用任何模板创建 Unity 项目。
  2. Assets文件夹中,创建一个名为MyElement.cs内容如下:
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构建器中将其打开。
  3. 在 UI 生成器的“库”部分中,选择“项目”>“自定义控件 (C#)”>“MyElement”。
  4. MyElement 拖到“层次结构”窗口。
  5. 要查看 MyElement 的自定义属性,请转到检查器一个 Unity 窗口,显示有关当前选定游戏对象、资产或项目设置的信息,允许您检查和编辑值。更多信息
    请参阅术语表
    选项卡
自定义控件的自定义属性
自定义控件的自定义属性

其他资源

使用 Toggle 创建条件 UI
创建幻灯片切换自定义控件