DropdownField

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

注意：要将元素与检视面板 (Inspector) 窗口中的其他字段对齐，只需对其应用 .unity-base-field__aligned USS 类。有关更多信息，请参阅 BaseField。

创建 DropdownField

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

UI Builder

要在 UI Builder 中为 DropdownField 添加选项，请转到 DropdownField 的 Inspector 面板，在 Choices 中输入由逗号分隔的选项。

要设置默认值，请转到 DropdownField 的 Inspector，在 Index 中输入从 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. 在层级视图 (Hierarchy) 窗口中，选择 UI 文档 (UI Document) (.uxml)。
2. 将面板设置 (Panel Settings) 设置为面板设置资源。如果您没有现有的面板设置资源，请按照对话框中的说明进行创建。
3. 在面板设置 (Panel Settings) 资源中，分配主题样式表。
4. 在项目 (Project) 窗口中，选择 TSS 文件。
5. 转到样式表 (Style Sheets) 并选择添加 (Add) (+) 按钮。
6. 将样式表 (Style Sheets) 设置为 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 中实时试用此示例，请转到窗口 (Window) > UI 工具包 (UI Toolkit) > 示例 (Samples)。

C# 基类和命名空间

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

继承 UXML 属性

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

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

USS 类

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

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

其他资源

• RadioButtonGroup