切换

切换包括图像和标签。就像其他标准 UI 工具包控件（如 Button）一样，Toggle 附加了一个 Clickable纵器，该纵器注册到MouseUpEvent和PointerUpEvent.当其中一个事件触发纵器时，切换的值会从true自false或从false自true.您可以读取或设置切换的当前值。您还可以将 Toggle 绑定到Boolean变量。

您可以根据其他条件（例如从下拉列表中选择的元素或启用的选项）显示或隐藏元素。条件 UI 的一个示例是 Unity相机在场景中创建特定视点图像的组件。输出要么绘制到屏幕上，要么作为纹理捕获。更多信息
请参阅术语表 检查器一个 Unity 窗口，显示有关当前选定游戏对象、资产或项目设置的信息，允许您检查和编辑值。更多信息
请参阅术语表.当您激活物理摄像机模式时，它会显示其他选项。

注意：要将元素与 Inspector 窗口中的其他字段对齐，只需将.unity-base-field__alignedUSS 级。有关更多信息，请参阅BaseField.

创建切换

你可以使用 UI Builder、UXML 或 C# 创建 Toggle。

以下 C# 示例创建具有特定标签的 Toggle：

Toggle myToggle = new Toggle("Click me");

样式 a 切换

默认情况下，“切换”控件显示为复选框。您可以应用样式，使其看起来像典型的切换开关。

要设置切换复选框的样式，请使用.unity-toggle__input和.unity-toggle__checkmarkstyle 属性。例如，如果您应用了名为className到 Toggle。以下 USS 在选择或清除切换开关时更改复选框的背景图像：

/* Set the background image when the checkbox is selected. */
.className:checked > .unity-toggle__input > .unity-toggle__checkmark {
    background-image: url("path/to/image-file");
}

/* Set the background image When the checkbox is not selected. */
.className > .unity-toggle__input > .unity-toggle__checkmark {
    background-image: url("path/to/image-file"); 
}

例子

以下UXML示例创建了一个切换：

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

以下 C# 示例演示了 Toggle 的一些可自定义功能：

/// <sample>
// Get a reference to the field from UXML and assign a value to it.
var uxmlField = container.Q<Toggle>("the-uxml-field");
uxmlField.value = true;

// Create a new field, disable it, and give it a style class.
var csharpField = new Toggle("C# Field");
csharpField.value = false;
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<bool>>((evt) =>
{
    csharpField.value = evt.newValue;
});
/// </sample>

若要在 Unity 中实时试用此示例，请转到 Window > UI 工具包>示例。

有关更多示例，请参阅以下内容：

• 创建条件 UI。

C# 基类和命名空间

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

继承的UXML属性

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

此元素还继承了以下属性VisualElement:

USS 级

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

您还可以使用 Inspector 或 UI Toolkit Debugger 中的 Matching Selectors 部分来查看哪些 USS 选择器会影响VisualElement在其层次结构的各个层面。

其他资源

• 插页
• 伪类