UXML 元素 Toolbar

一个 ToolbarUnity 编辑器顶部的一行按钮和基本控件，允许您以各种方式与编辑器交互（例如缩放、平移）。更多信息
参见词汇表是一个仅限编辑器控件，用作水平容器。您可以将任何 视觉元素可视化树的一个节点，它实例化或派生自 C# VisualElement 类。您可以设置外观样式、定义行为，并将其显示在屏幕上作为 UI 的一部分。更多信息
参见词汇表添加到 Toolbar 中，但为了在 Toolbar 中保持一致的视觉样式，请使用以下元素，因为它们具有与 Toolbar 样式匹配的预定义样式

使用 ToolbarButton 代替 Button。
使用 ToolbarToggle 代替 Toggle一个复选框，允许用户打开或关闭某个选项。更多信息
参见词汇表。
ToolbarSearchField
ToolbarPopupSearchField
使用 ToolbarMenu 代替 DropdownField。
ToolbarSpacer
ToolbarBreadcrumbs

创建 Toolbar

您可以使用 UI(用户界面) 允许用户与您的应用程序交互。Unity 目前支持三种 UI 系统。更多信息
参见词汇表构建器、UXML 或 C# 创建 Toolbar。以下 C# 示例创建了一个包含按钮和切换按钮的 Toolbar

using UnityEditor.UIElements;
...
var toolbar = new Toolbar();
var button = new ToolbarButton(() => { Debug.Log("Button clicked"); }) { text = "Click me" };
toolbar.Add(button);
toolbar.Add(new ToolbarToggle() { text = "Toggle me" });

C# 基类和命名空间

C# 类：Toolbar
命名空间：UnityEditor.UIElements
基类：VisualElement

继承的 UXML 属性

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

名称	类型	描述
`focusable`	`布尔值`	如果元素可以获得焦点，则为真。
`tabindex`	`整数`	用于在焦点环中对可聚焦元素进行排序的整数。必须大于或等于零。

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

名称	类型	描述
`content-container`	`字符串`	子元素添加到其中，通常与元素本身相同。
`data-source`	`对象`	为该 VisualElement 分配数据源，覆盖任何继承的数据源。此数据源由所有子项继承。
`data-source-path`	`字符串`	从数据源到值的路径。
`data-source-type`	`System.Type`	可分配给此 VisualElement 的数据源的可能类型。此信息仅供 UI 构建器使用，作为提示，在设计时无法指定有效数据源时，为数据源路径字段提供一些自动完成。
`language-direction`	`UIElements.LanguageDirection`	指示元素文本的方向性。该值将传播到元素的子元素。将 languageDirection 设置为 RTL 通过反转文本并适当地处理换行和自动换行来添加对从右到左 (RTL) 的基本支持。但是，它不提供全面的 RTL 支持，因为这需要文本整形，包括字符的重新排序和 OpenType 字体功能支持。全面的 RTL 支持计划在未来的更新中提供，这将涉及用于处理语言、脚本和字体功能规范的其他 API。为了增强此属性的 RTL 功能，用户可以探索 Unity Asset Store 中可用的第三方插件并使用 `ITextElementExperimentalFeatures.renderedText`
`name`	`字符串`	此 VisualElement 的名称。使用此属性编写针对特定元素的 USS 选择器。标准做法是为元素提供唯一的名称。
`picking-mode`	`UIElements.PickingMode`	确定此元素在鼠标事件或 `IPanel.Pick` 查询期间是否可以选择。
`style`	`字符串`	设置 `VisualElement` 样式值。
`tooltip`	`字符串`	在用户将鼠标悬停在元素上一段时间后，在信息框内显示的文本。这仅在编辑器 UI 中受支持。
`usage-hints`	`UIElements.UsageHints`	指定 `VisualElement` 高级预期使用模式的提示值组合。此属性仅在 `VisualElement` 尚未成为 `Panel` 的一部分时才能设置。一旦成为 `Panel` 的一部分，此属性便有效地变为只读，尝试更改它将引发异常。正确 `UsageHints` 的规范会驱动系统根据预期的使用模式做出更好的决策，以处理或加速某些操作。请注意，这些提示不会影响行为或视觉结果，只会影响面板和其中元素的整体性能。建议始终考虑指定正确的 `UsageHints`，但请记住，在某些情况下（例如由于目标平台上的硬件限制），某些 `UsageHints` 可能会在内部被忽略。
`view-data-key`	`字符串`	用于视图数据持久性，例如树展开状态、滚动位置或缩放级别。此键用于从视图数据存储中保存和加载视图数据。如果未设置此键，则关联的 `VisualElement` 会禁用持久性。有关更多信息，请参阅视图数据持久性。

USS 类

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

C# 属性	USS 选择器	描述
`ussClassName`	`.unity-toolbar`	此类型元素的 USS 类名称。
`disabledUssClassName`	`.unity-disabled`	本地禁用元素的 USS 类名称。

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

其他资源

UXML 元素 ToggleButtonGroup

UXML 元素 ToolbarBreadcrumbs