ToolbarButton

ToolbarButton 是一个仅限编辑器的控件，用作工具栏中的按钮。这是一个具有与工具栏样式相匹配的预定义样式的 Button。

创建 ToolbarButton

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

using UnityEditor.UIElements;
...
var toolbarButton = new ToolbarButton(() => { Debug.Log("Button clicked"); }) { text = "Click me" };

C# 基类和命名空间

C# 类：ToolbarButton
命名空间：UnityEditor.UIElements
基类：Button

继承 UXML 属性

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

名称	类型	描述
`binding-path`	`string`	要绑定的目标属性的路径。
`display-tooltip-when-elided`	`boolean`	如果为 true，则工具提示会显示完整版本的省略文本；如果之前提供了工具提示，则工具提示将被覆盖。
`emoji-fallback-support`	`boolean`	指定系统在渲染文本时查找表情字符的顺序。如果启用此设置，则会首先在全局表情回退列表中搜索被 Unicode 14.0 标准定义为表情的字符。
`enable-rich-text`	`boolean`	如果为 false，则不会解析富文本标签。
`focusable`	`boolean`	如果元素可以聚焦，则为 true。
`icon-image`	`Object`	表示 Button 元素中图标的纹理、精灵或 VectorImage。
`parse-escape-sequences`	`boolean`	指定转义序列是按原样显示，还是被它们所代表的字符替换。
`tabindex`	`int`	用于对焦点环中可获得焦点的元素排序的整数。必须大于或等于零。
`text`	`string`	要显示的文本。更改此值将隐式调用 `INotifyValueChanged_1.value` 资源库，这将引发字符串类型的 `ChangeEvent_1`。

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

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

USS 类

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

C# 属性	USS 选择器	描述
`ussClassName`	`.unity-toolbar-button`	此类型元素的 USS 类名称。
`ussClassName`	`.unity-button`	此类型元素的 USS 类名称。 Unity 将此 USS 类添加到 Button 元素的每个实例。应用于此类的任何样式都会影响位于视觉树中样式表旁边或下方的每个按钮。
`iconUssClassName`	`.unity-button--with-icon`	带有图标的 Button 元素的 USS 类名称。如果 Button 元素的 `Button.iconImage` 属性包含有效纹理，Unity 会将此 USS 类添加到该元素的实例中。应用于此类的任何样式都会影响每个按钮，每个按钮的图标都位于视觉树中的样式表旁边或下方。
`ussClassName`	`.unity-text-element`	此类型元素的 USS 类名称。
`selectableUssClassName`	`.unity-text-element__selectable`	可选文本元素的 USS 类名称。
`disabledUssClassName`	`.unity-disabled`	本地被禁用元素的 USS 类名称。

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

其他资源

ToolbarBreadcrumbs

ToolbarMenu

Unity 手册