版本:Unity 6 (6000.0)
语言:English
UXML 元素 Toolbar
UXML 元素 ToolbarButton

UXML 元素 ToolbarBreadcrumbs

ToolbarBreadcrumbs 是一种仅限编辑器控件,用作面包屑导航栏。它具有与ToolbarUnity 编辑器顶部的一行按钮和基本控件,允许您以各种方式与编辑器交互(例如缩放、平移)。更多信息
参见 术语表
样式匹配的预定义样式。

An example ToolbarBreadcrumbs
ToolbarBreadcrumbs 示例

创建 ToolbarBreadcrumbs

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

using UnityEditor.UIElements;
...
var toolbarBreadcrumbs = new ToolbarBreadcrumbs();

// Use the PushItem() method to add an item to the breadcrumbs. The method takes a string and an optional callback.
toolbarBreadcrumbs.PushItem("myItemGrandParent", GoToRoot);

// Use the PopItem() method to remove the last item from the breadcrumbs.
toolbarBreadcrumbs.PushItem("myItemParent", () => toolbarBreadcrumbs.PopItem());
toolbarBreadcrumbs.PushItem("myItem");

void GoToRoot()
{
    while (toolbarBreadcrumbs.childCount > 1)
        toolbarBreadcrumbs.PopItem();
}

C# 基类和命名空间

C# 类ToolbarBreadcrumbs
命名空间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-breadcrumbs 主要 ToolbarBreadcrumbs 容器的 Unity 样式表 (USS) 类。
disabledUssClassName .unity-disabled 本地禁用元素的 USS 类名。

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

其他资源

UXML 元素 Toolbar
UXML 元素 ToolbarButton