Unity3D ：UXML 元素切换
推荐：将NSDT场景编辑器加入你的3D工具链
3D工具集：NSDT简石数字孪生
UXML 元素切换
切换包括图像和标签。就像其他标准一样用户界面
工具包控件，例如按钮、切换器，附加了一个可单击的操纵器，该操纵器注册到 MouseUpEvent 和 PointerUpEvent。当其中一个事件触发操纵器时，切换的值将从真变为假或从假变为真。您可以读取或设置切换开关的当前值。您还可以将 T切换绑定到布尔变量。
默认情况下，切换控件显示为复选框。您可以应用样式以使其看起来像典型的切换开关。
您可以根据其他条件显示或隐藏元素，例如从下拉列表中选择或启用的选项。条件 UI 的一个示例是 Unity照相机
检查员
.当您激活物理摄像机模式时，它会显示其他选项。
响应用户操作
切换响应更改事件。
例子
要查看简单的切换示例，请在 Unity 中选择“窗口> UI 工具包”>“示例”>“切换”。
有关更复杂的切换示例，请参阅创建条件 UI。
C# 基类和命名空间
C# 类：切换
命名空间：基类：基布尔字段UnityEngine.UIElements
继承的属性
此元素从其基类继承以下属性：
| 名字 | 类型 | 描述 |
|---|---|---|
binding-path | string | 要绑定的目标属性的路径。 |
focusable | boolean | 如果元素可以聚焦，则为 True。 |
label | string | 表示将显示在字段旁边的标签的字符串。 |
tabindex | int | 用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。 |
text | string | 显示在基本布尔字段之后的可选文本。 如果不存在，Unity 会自动创建一个。 Label |
value | boolean | 与字段关联的值。 |
此元素还从可视元素继承以下属性：
| 名字 | 类型 | 描述 |
|---|---|---|
content-container | string | 子元素被添加到其中，通常这与元素本身相同。 |
name | string | 此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。 |
picking-mode | UIElements.PickingMode | 确定是否可以在鼠标事件或查询期间选取此元素。IPanel.Pick |
style | string | 引用此元素的样式对象。 包含从 USS 文件或以 C# 写入此对象的内联样式计算的数据。 |
tooltip | string | 用户将元素悬停一小段时间后要在信息框中显示的文本。 |
usage-hints | UIElements.UsageHints | 提示值的组合，用于指定 的高级预期使用模式。仅当 尚未成为 的一部分时，才能设置此属性。一旦 的一部分，此属性将变为有效的只读，并且尝试更改它将引发异常。适当的规范驱动系统根据预期的使用模式就如何处理或加速某些操作做出更好的决策。请注意，这些提示不会影响行为或视觉结果，而只会影响面板和其中元素的整体性能。建议始终考虑指定正确的 ，但请记住，在某些情况下（例如，由于目标平台上的硬件限制），某些可能会在内部被忽略。VisualElementVisualElementPanelPanelUsageHintsUsageHintsUsageHints |
view-data-key | string | 用于视图数据持久性（即树展开状态、滚动位置、缩放级别）。 这是用于从视图数据存储保存/加载视图数据的键。不设置此项将禁用此 的持久性。 VisualElement |
美国航空母舰类
下表列出了所有 C# 公共属性名称及其相关的 USS 选择器。
| C# 属性 | 美国航空母舰选择器 | 描述 |
|---|---|---|
ussClassName | .unity-toggle | 切换元素的 USS 类名。 Unity 将此 USS 类添加到 Toggle 元素的每个实例中。应用于此类的任何样式都会影响可视化树中样式表旁边或下方的每个 Toggle。 |
labelUssClassName | .unity-toggle__label | 切换元素中标签的 USS 类名。 Unity 将此 USS 类添加到 if 切换具有标签的子元素中。 LabelToggle |
inputUssClassName | .unity-toggle__input | 切换元素中输入元素的 USS 类名。 Unity 将此 USS 类添加到 的输入子元素中。输入子元素提供对操纵器的响应。 Toggle |
noTextVariantUssClassName | .unity-toggle--no-text | 没有文本的切换元素的 USS 类名。 Unity 将此 USS 类添加到 如果切换没有标签。 Toggle |
checkmarkUssClassName | .unity-toggle__checkmark | 切换元素中图像的 USS 类名。 Unity 将此 USS 类添加到包含复选标记图像的 的图像子元素中。 Toggle |
textUssClassName | .unity-toggle__text | 切换元素中文本元素的 USS 类名。 Unity 将此 USS 类添加到 的文本子元素中。 Toggle |
ussClassName | .unity-base-field | 此类型元素的 USS 类名。 |
labelUssClassName | .unity-base-field__label | 此类型元素中标签的 USS 类名。 |
inputUssClassName | .unity-base-field__input | 此类型元素中输入元素的 USS 类名。 |
noLabelVariantUssClassName | .unity-base-field--no-label | 此类型元素的 USS 类名（当没有标签时）。 |
labelDraggerVariantUssClassName | .unity-base-field__label--with-dragger | 此类型元素中标签的 USS 类名，当它们上附加了拖动器时。 |
mixedValueLabelUssClassName | .unity-base-field__label--mixed-value | 显示混合值的元素的 USS 类名 |
alignedFieldUssClassName | .unity-base-field__aligned | 在检查器元素中对齐的元素的 USS 类名 |
disabledUssClassName | .unity-disabled | 本地禁用元素的 USS 类名。 |
您还可以使用检查器中的“匹配选择器”部分或 UI 工具包调试器来查看哪些 USS 选择器在其层次结构的每个级别影响 的组件。VisualElement
由3D建模学习工作室整理翻译，转载请注明出处！