RadioButton

当多个 RadioButton 在同一组中使用时，用户只能选择其中一个选项。您可以使用 GroupBox 对 RadioButton 进行分组。否则，panel 将作为默认组。

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

创建 RadioButton

您可以使用__ UI__（即用户界面，User Interface）让用户能够与您的应用程序进行交互。Unity 目前支持三种 UI 系统。更多信息
See in Glossary Builder、UXML 或 C# 创建 RadioButton。以下 C# 示例将在同一容器中创建两个新的单选按钮，并在面板中将它们在逻辑上归为一组。

var choice1 = new RadioButton() { text = "Choice 1" };
choice1.RegisterValueChangedCallback(v => Debug.Log("Choice 1 is : " + v.newValue));
var choice2 = new RadioButton() { text = "Choice 2" };
choice2.RegisterValueChangedCallback(v => Debug.Log("Choice 2 is : " + v.newValue));
container.Add(choice1);
container.Add(choice2);

示例

以下 UXML 示例将创建 RadioButton：

<UXML xmlns="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements">
    <GroupBox>
        <RadioButton label="UXML Field 1" name="the-uxml-field1" />
        <RadioButton label="UXML Field 2" name="the-uxml-field2" />
    </GroupBox>
</UXML>

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

/// <sample>
// Note: See also RadioButtonGroup in the ChoiceField section of UI Toolkit Samples

// Get a reference to the first radio button from UXML and assign a value to it.
var uxmlField1 = container.Q<RadioButton>("the-uxml-field1");
var uxmlField2 = container.Q<RadioButton>("the-uxml-field2");
uxmlField1.value = true;

// Create two RadioButtons in a separate group, disable them, and give them a style class.
var groupBox = new GroupBox();
container.Add(groupBox);

var csharpField1 = new RadioButton("C# Field 1");
csharpField1.SetEnabled(false);
csharpField1.AddToClassList("some-styled-field");
groupBox.Add(csharpField1);

var csharpField2 = new RadioButton("C# Field 2");
csharpField2.SetEnabled(false);
csharpField2.AddToClassList("some-styled-field");
groupBox.Add(csharpField2);

csharpField1.value = uxmlField1.value;

// Mirror the value of the UXML field into the C# field.
uxmlField1.RegisterCallback<ChangeEvent<bool>>((evt) =>
{
    csharpField1.value = evt.newValue;
});
uxmlField2.RegisterCallback<ChangeEvent<bool>>((evt) =>
{
    csharpField2.value = evt.newValue;
});
/// </sample>

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

C# 类和命名空间

C# 类：RadioButton
命名空间：UnityEngine.UIElements
基类：BaseBoolField

继承 UXML 属性

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

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

USS 类

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

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

其他资源

• RadioButtonGroup
• GroupBox