UXML 元素 DropdownField

DropdownField 允许用户从列表中选择一个值。单击控件时，它会打开一个抽屉，其中显示多个选项，允许用户选择其中一个。如果要始终显示所有选项，请使用RadioButtonGroup。

注意：要使元素与 检视器一个 Unity 窗口，显示有关当前选定游戏对象、资源或项目设置的信息，允许您检查和编辑这些值。更多信息
请参阅词汇表窗口中的其他字段对齐，只需向其应用.unity-base-field__aligned USS 类。有关更多信息，请参阅BaseField。

创建 DropdownField

您可以使用UI(用户界面) 允许用户与您的应用程序交互。Unity 目前支持三种 UI 系统。更多信息
请参阅词汇表构建器、UXML 或 C# 创建 DropdownField。

UI 构建器

要在 UI 构建器中为 DropdownField 添加选项，请在 DropdownField 的检视器面板中，在选项中输入以逗号分隔的选项。

要设置默认值，请在 DropdownField 的检视器中，在索引中输入选项的编号序列，从0开始。

C#

以下 C# 示例创建了一个带有三个选项的 DropdownField。DropdownField 默认选择第一个选项

var dropdown = new DropdownField("Options", new List<string> { "Option 1", "Option 2", "Option 3" }, 0);

//Add another option
dropdown.choices.Add("Option 4");

// To return int value instead of string
dropdown.index = 1; // Option 2
dropdown.value = "Option3";
Assert.IsTrue(myDropdown.index == 2);

// Register to the value changed callback
dropdown.RegisterValueChangedCallback(evt => Debug.Log(evt.newValue));

更改 DropdownField 的样式

您可以覆盖 USS 文件中的默认面板设置字段以更改 DropdownField 的样式

1. 在层次结构窗口中，选择您的 UI 文档 (.uxml)。
2. 将面板设置设置为您的面板设置资源。如果您没有现有的面板设置资源，请按照对话框中的说明创建一个。
3. 在您的面板设置资源中，分配主题样式表。
4. 在项目窗口中，选择您的 TSS 文件。
5. 转到样式表并选择添加（+）按钮。
6. 将您的样式表设置为您的USS 文件。

示例

以下 UXML 示例创建了一个 DropdownField

<UXML xmlns="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements">
    <DropdownField label="UXML Field" name="the-uxml-field" />
</UXML>

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

/// <sample>
// You can provide the list of choices by code, or by comma separated values in UXML
// <DropdownField .... choices="Option 1,Option 2,Option 3" .... />
var choices = new List<string> { "Option 1", "Option 2", "Option 3" };

// Get a reference to the dropdown field from UXML and assign a value to it.
var uxmlField = container.Q<DropdownField>("the-uxml-field");
uxmlField.choices = choices;
uxmlField.value = choices[0];

// Create a new dropdown with the same choices, disable it, and give it a style class.
var csharpField = new DropdownField("C# Field", choices, 0);
csharpField.SetEnabled(false);
csharpField.AddToClassList("some-styled-field");
container.Add(csharpField);

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

要在 Unity 中实时尝试此示例，请转到窗口>UI 工具包>示例。

C# 基类和命名空间

C# 类：DropdownField
命名空间：UnityEngine.UIElements
基类：PopupField_1

继承的 UXML 属性

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

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

USS 类

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

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

其他资源

• RadioButtonGroup