UXML 元素 EnumFlagsField

EnumFlagsField 允许用户从枚举中选择多个标记有 Flags 属性的值。

注意：要使 EnumFlagsField 与 InspectorUnity 窗口，显示当前选定的 GameObject、资源或项目设置的信息，允许您检查和编辑值。 更多信息
参见 术语表 窗口中的其他字段对齐，只需向其应用 .unity-base-field__aligned USS 类。有关更多信息，请参阅 BaseField。

创建 EnumFlagsField

您可以使用 UXML 和 C# 创建 EnumField。

假设您有以下枚举

[Flags]
enum MyEnum
{
    None = 0,
    First = 1,
    Second = 2,
    Third = 4
}

以下 C# 示例创建了一个使用 MyEnum 枚举的 EnumFlagsField，并选择了第一个和第二个值

var myEnumFlagsField = new EnumFlagsField("Select Options", MyEnum.First | MyEnum.Second);

示例

以下 UXML 示例创建了一个 EnumFlagsField 元素

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

以下 C# 示例说明了 EnumFlagsField 元素的一些可自定义功能

/// <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<EnumFlagsField>("the-uxml-field");
uxmlField.Init(EnumFlags.First);
uxmlField.value = EnumFlags.Second;

// Create a new field, disable it, and give it a style class.
var csharpField = new EnumFlagsField("C# Field", uxmlField.value);
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 中实时尝试此示例，请转到 窗口 > UI 工具包 > 示例。

C# 基类和命名空间

C# 类：EnumFlagsField
命名空间：UnityEditor.UIElements
基类：BaseMaskField_1

继承的 UXML 属性

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

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

USS 类

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

您还可以使用 Inspector 或 UI 工具包调试器中的匹配选择器部分 来查看哪些 USS 选择器影响其层次结构中每个级别的 VisualElement 的组件。

其他资源

• UXML 元素 EnumField