EnumField

EnumField 允许用户从枚举中选择值。

注意：要将枚举字段与 Inspector 窗口中的其他字段对齐，只需将 .unity-base-field__aligned USS 类加以应用即可。有关更多信息，请参阅 BaseField。

创建 EnumField

您可以使用__ UI__（即用户界面，User Interface）让用户能够与您的应用程序进行交互。Unity 目前支持三种 UI 系统。更多信息
See in Glossary Builder、UXML 和 C# 创建 EnumField。

假设您有以下枚举：

enum ColorOptions
{
    Red,
    Green,
    Blue,
    Yellow
}

以下 C# 示例将使用 ColorOptions 枚举创建一个 EnumField，并将默认值设置为 Red：

EnumField myElement = new EnumField("Label text", ColorOptions.Red);

示例

以下 UXML 示例将创建一个 EnumField：

<UXML xmlns="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements">
    <EnumField label="UXML Field" name="the-uxml-field" include-obsolete-values="false"/>
</UXML>

以下 C# 示例说明了 EnumField 的一些可自定义功能：

/// <sample>
// Get a reference to the field from UXML,
// initialize it with an Enum type,
// and assign a value to it.
var uxmlField = container.Q<EnumField>("the-uxml-field");
uxmlField.Init(TextAlignment.Center);
uxmlField.value = TextAlignment.Left;

// Create a new field, disable it, and give it a style class.
var csharpField = new EnumField("C# Field", TextAlignment.Center);
csharpField.SetEnabled(false);
csharpField.AddToClassList("some-styled-field");
csharpField.value = uxmlField.value;
container.Add(csharpField);

// Mirror the value of the UXML field into the C# field.
uxmlField.RegisterCallback<ChangeEvent<Enum>>((evt) =>
{
    csharpField.value = evt.newValue;
});
/// </sample>

要在 Unity 中实时试用此示例，请转到窗口 (Window) > UI 工具包 (UI Toolkit) > 示例 (Samples)。

C# 基类和命名空间

C# 类：EnumField
命名空间：UnityEngine.UIElements
基类：BaseField_1

继承 UXML 属性

此元素从其基类继承以下属性：

此元素还从 VisualElement 继承以下属性：

USS 类

下表列出了所有 C# 公共属性名称及其相关的 USS 选择器。

还可以使用检视器中的匹配选择器 (Matching Selectors) 部分或 UI 工具包调试器来查看哪些 USS 选择器在其层级视图的每个级别上影响 VisualElement 的组件。

其他资源

• EnumFlagsField