Unity3D Unity3D ：UXML 元素 Hash128Field 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 UXML 元素 Hash128Field C# 类：哈希128字段 命名空间：基类： TextInputBaseField_1UnityEngine.UIElements 继承的属性 此元素从其基类继承以下属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。focusableboolean如果元素可以聚焦，则为 True。is-delayedboolean如果设置为 true，则在用户按 Enter 或文本字段失去焦点之前，不会更新 value 属性。labelstring表示将显示在字段旁边的标签的字符串。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。valuestring与字段关联的值。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是
Unity3D Unity3D ：UXML 元素分组框 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 UXML 元素分组框 GroupBox 是多个逻辑组的容器元素视觉元素 .如果要在同一面板中包含多组选项，则可以结合使用 GroupBox 和单选按钮。 如果要将单选按钮组视为单个字段，请使用单选按钮组。在大多数情况下，最好使用 RadioButtonGroup，因为在使用 GroupBox 和 RadioButton 组合时必须注册每个单选按钮。但是，如果要在组中添加其他可视元素，请使用组合。 使用 C# 脚本创建分组框 以下 C# 代码片段创建一个 GroupBox，并向其添加三个单选按钮，以便对它们进行逻辑分组。 var group = new GroupBox("Group Example"); // Must register change events on each radio button. var choice1
Unity3D Unity3D ：UXML 元素 GradientField 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 UXML 元素 GradientField C# 类：梯度字段 命名空间：基类： BaseField_1UnityEditor.UIElements 继承的属性 此元素从其基类继承以下属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。focusableboolean如果元素可以聚焦，则为 True。labelstring表示将显示在字段旁边的标签的字符串。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。picking-modeUIElements.PickingMode确定是否可以在鼠标事件或查询期间选取此元素。IPanel.Pickstylestring引用此元素
Unity3D Unity3D ：UXML 元素折叠 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 UXML 元素折叠 折叠是用户界面 .折叠页会在您单击其标题时隐藏或显示它所包含的元素。 创建折叠页 折叠具有以下元素： * 标签：可用作折叠页名称的标签。 * 切换：单击切换开关以展开或折叠容器子元素。它的样式看起来像箭头，而不是默认复选框。当容器折叠时，箭头指向右。展开容器时，箭头指向下方。 * 容器：容器包含视觉元素 要在切换折叠时显示或隐藏。 您可以将元素添加到折叠的容器中，显示或隐藏功能会自动工作。 以下 UI 文档创建一个折叠，其容器中有两个按钮。当您切换折叠时，这两个按钮显示或隐藏。 Unity3D Unity3D ：UXML 元素 FloatField 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML 元素 FloatField C# 类：浮点字段 命名空间：基类： TextValueField_1UnityEngine.UIElements 继承的属性 此元素从其基类继承以下属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。focusableboolean如果元素可以聚焦，则为 True。is-delayedboolean如果设置为 true，则在用户按 Enter 或文本字段失去焦点之前，不会更新 value 属性。labelstring表示将显示在字段旁边的标签的字符串。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。valuefloat这是字段的值。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名 Unity3D Unity3D ：UXML 元素 EnumFlagsField 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML 元素 EnumFlagsField C# 类：枚举标志字段 命名空间：基类： BaseMaskField_1UnityEditor.UIElements 继承的属性 此元素从其基类继承以下属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。focusableboolean如果元素可以聚焦，则为 True。labelstring表示将显示在字段旁边的标签的字符串。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。valuestring与字段关联的值。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。picking-modeUIElements.PickingMode确定是否可以在鼠标事件或查询期间选取此元素。I Unity3D Unity3D ：UXML 元素 EnumField 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML 元素 EnumField C# 类：枚举字段 命名空间：基类： BaseField_1UnityEngine.UIElements 继承的属性 此元素从其基类继承以下属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。focusableboolean如果元素可以聚焦，则为 True。labelstring表示将显示在字段旁边的标签的字符串。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。valuestring与字段关联的值。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。picking-modeUIElements.PickingMode确定是否可以在鼠标事件或查询期间选取此元素。IPanel.Picks Unity3D Unity3D ：UXML 元素 DropdownField 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML 元素 DropdownField 下拉字段允许用户从列表中选择一个值。单击控件时，它会打开一个抽屉，其中显示多个选项，允许用户选择一个选项。如果要始终显示所有选项，请使用单选按钮组。 响应用户操作 下拉字段响应更改事件。 您可以将 DropdownField 绑定到保存所选选项值的字符串变量。 在 UI 生成器中添加下拉列表字段的选项 若要为下拉列表字段添加选项，请在检查员 ，在“选项”中输入以逗号分隔的选项。 要设置默认值，请在“下拉字段”的检查器中，输入“索引”中选项的编号顺序，从 开始。0 在 C# 脚本中创建下拉列表字段 以下 C# 代码片段创建一个包含三个选项的下拉列表字段。默认情况下，下拉字段选择第一个选项。 var dropdown = new DropdownField("Options" Unity3D Unity3D ：UXML元素DoubleField 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML元素DoubleField C# 类：双字段 命名空间：基类： TextValueField_1UnityEngine.UIElements 继承的属性 此元素从其基类继承以下属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。focusableboolean如果元素可以聚焦，则为 True。is-delayedboolean如果设置为 true，则在用户按 Enter 或文本字段失去焦点之前，不会更新 value 属性。labelstring表示将显示在字段旁边的标签的字符串。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。valuedouble这是字段的值。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称 Unity3D Unity3D ：UXML 元素 CurveField 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML 元素 CurveField C# 类：曲线字段 命名空间：基类： BaseField_1UnityEditor.UIElements 继承的属性 此元素从其基类继承以下属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。focusableboolean如果元素可以聚焦，则为 True。labelstring表示将显示在字段旁边的标签的字符串。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。picking-modeUIElements.PickingMode确定是否可以在鼠标事件或查询期间选取此元素。IPanel.Pickstylestring引用此元素的样式 Unity3D Unity3D ：UXML 元素色域 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML 元素色域 C# 类：色域 命名空间：基类： BaseField_1UnityEditor.UIElements 成员属性 此元素具有以下成员属性： 名字类型描述hdrboolean如果为 true，则将颜色视为高密度显示 价值。如果为 false，则将颜色视为标准 LDR 值。show-alphaboolean如果为 true，则允许用户设置颜色的 alpha 值。如果为 false，则隐藏 alpha 分量。show-eye-dropperboolean如果为 true，则颜色选取器将显示吸管控件。如果为 false，则颜色选取器不会显示吸管控件。 继承的属性 此元素从其基类继承以下属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。focusableboolean如果元素可以聚焦，则为 True。labelstring表示将显示在字段旁边的标签的字符串。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。 Unity3D Unity3D ：UXML 元素按钮 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML 元素按钮 使用 Button 元素在用户界面 .例如，当用户单击或点击 Button 元素时，它会触发操作或事件，例如打开新窗口、提交表单或播放声音效果。 使用按钮的子元素 可以使用按钮的 和属性向用户提供其他信息。如果您希望对这些元素的外观和行为进行更精细的控制，还可以在按钮的层次结构中添加子元素（如标签或图像），以便向用户提供其他信息。textbackground-image 通常，在以下情况下使用子元素： * 自定义：使用子元素可以单独自定义每个元素的外观和行为。例如，您可能希望对标签文本使用自定义字体或颜色，或者向图像添加特定动画。当您将图像元素添加到按钮时，您可以从现场 径直。此外，Image 元素还支持缩放模式和重复模式。 * 动态内容：如果标签或图像的内容是动态的，则使用子元素可以单独更新每个元素的内容，而不会影响按钮的其他属性。 * 交互：如果要为按钮中的特定元素添加交互性，例如允许用户仅单击标签（不考虑单击按钮的其他元素）以触发操作，则使用子元素可以 Unity3D Unity3D ：UXML 元素框 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML 元素框 C# 类：框 命名空间：基类： 视觉元素UnityEngine.UIElements 继承的属性 此元素从其基类继承以下属性： 名字类型描述focusableboolean如果元素可以聚焦，则为 True。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。picking-modeUIElements.PickingMode确定是否可以在鼠标事件或查询期间选取此元素。IPanel.Pickstylestring引用此元素的样式对象。 包含从 USS 文件或以 C# 写入此对象的内联样式计算的数据。tooltipstring用户将元素悬停一小段时间后要在信息框中显示的文本。usag Unity3D Unity3D ：UXML element BoundsIntField 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML element BoundsIntField C# 类：BoundsIntField 命名空间：基类： BaseField_1UnityEngine.UIElements 继承的属性 此元素从其基类继承以下属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。focusableboolean如果元素可以聚焦，则为 True。labelstring表示将显示在字段旁边的标签的字符串。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。picking-modeUIElements.PickingMode确定是否可以在鼠标事件或查询期间选取此元素。IPanel.Pick Unity3D Unity3D ：UXML 元素 BoundsField 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML 元素 BoundsField C# 类：边界字段 命名空间：基类： BaseField_1UnityEngine.UIElements 继承的属性 此元素从其基类继承以下属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。focusableboolean如果元素可以聚焦，则为 True。labelstring表示将显示在字段旁边的标签的字符串。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。picking-modeUIElements.PickingMode确定是否可以在鼠标事件或查询期间选取此元素。IPanel.Pickstylestring引用此元素的样 Unity3D Unity3D ：UXML 元素 VisualElement 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 UXML 元素 VisualElement C# 类：可视元素 命名空间：基类： 可聚焦UnityEngine.UIElements 成员属性 此元素具有以下成员属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。picking-modeUIElements.PickingMode确定是否可以在鼠标事件或查询期间选取此元素。IPanel.Pickstylestring引用此元素的样式对象。 包含从 USS 文件或以 C# 写入此对象的内联样式计算的数据。tooltipstring用户将元素悬停一小段时间后要在信息框中显示的文本。usage-hintsUIElements.UsageHints提示值的组合，用于指定 的高级预期使用模式。仅当 尚未成为 的一部分时，才能设置此属性。一旦 的一部分，此属性将变为有效 Unity3D Unity3D ：UXML 元素 BindableElement 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 UXML 元素 BindableElement C# 类：可绑定元素命名空间：基类： 可视元素 UnityEngine.UIElements 成员属性 此元素具有以下成员属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。 继承的属性 此元素从其基类继承以下属性： 名字类型描述focusableboolean如果元素可以聚焦，则为 True。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。picking-modeUIElements.PickingMode确定是否可以在鼠标事件或查询期间选取此元素。IPanel.Pickstylestring引用此元素的样式对 Unity3D Unity3D ：使用逻辑封装 UXML 文档 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 使用逻辑封装 UXML 文档 一个预 置是预制的游戏对象您可以在现场.预制件对于创建可重用组件非常有用。视觉元素在用户界面工具包不是游戏对象，因此预制件不适用。但是，可以将自定义控件创建为可重用的 UI 组件，该组件使用逻辑封装元素的特定层次结构。由于 UI 工具包鼓励您将 UI 与游戏或应用程序代码分开，因此可以使用 UXML 定义结构，使用 USS 定义外观，并使用 C# 定义自定义控件的逻辑。 创建可重用的 UI 组件 创建可重用的 UI 组件，例如为卡片调用的自定义控件，该控件显示角色的图像以及生命和攻击统计信息，如下所示：CardElement 以下是完成此操作的一般步骤： 1. 在 C# 中，声明一个名为 CardElement 的自定义元素类型。 在 Unity3D Unity3D ：管理元素的最佳做法 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 管理元素的最佳做法 本页介绍在可视化树 . 预先创建层次结构 创建元素并将其加载到层次结构中是一项缓慢的操作。为了避免这种情况，您可以在层次结构中预先创建元素，并用于隐藏它们并仅在需要时显示它们。但是，同时创建多个元素可能会消耗更多内存。display:none 池重复元素 元素池化是为了保留以后可能会重新创建的元素，而不是每次都创建元素并放弃它们。new() 请务必完全控制池化的所有元素，并确保在将它们返回到池之前正确重置它们。否则，池化系统可能会变得不稳定和麻烦。例如，如果在注册事件回调或同时设置内部非序列化状态时池化元素，则无法清理元素。 保持少量可见元素 要保持数量视觉元素 低，尽可能使用列表视图。ListView 池化元素并在用户滚动时回收元素。 或者，您可以实现自己的池和回收机制，类似于 ListView，并使用以下命令来管理可见区域： * 要观察容器的大小，请使用 GeometryChangedEvent * 若要计算子级的大小，请使用 VisualElem Unity3D Unity3D ：自定义 UXML 标记名称和属性 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 自定义 UXML 标记名称和属性 可以自定义 UXML 标记名称、重写基类属性的默认值或限制自定义控件的接受属性。 自定义 UXML 标签名称 默认情况下，自定义控件的 UXML 中的标记名称是 C# 类名称。不建议标记的名称与 C# 类的名称不同。但是，如果存在名称冲突，您可以自定义标记名称。 要自定义 UXML 标记名称，请覆盖其 和 属性。确保以下几点：IUxmlFactory.uxmlNameIUXmlFactory.uxmlQualifiedName * uxmlName在您的命名空间中是唯一的 * uxmlQualifiedName在您的项目中独一无二 如果两个名称都不唯一，Unity 会在加载程序集时引发异常。 下面的代码示例重写并自定义 UXML 标记名称： public class FactoryWithCustomName : UxmlFactory<..., ...> { public override Unity3D Unity3D ：向 UXML 和 UI 生成器公开自定义控件 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 向 UXML 和 UI 生成器公开自定义控件 将自定义控件与 UXML 一起使用，并且用户界面 构建器，您必须公开它们。 定义工厂 若要定义新元素，请从 或其子类之一派生新类，然后在此新类中实现相应的功能。VisualElement 新类必须实现默认构造函数。例如： class StatusBar : VisualElement { public StatusBar() { m_Status = String.Empty; } string m_Status; public string status { get; set; } } 为了使 UI 工具包在读取 UXML 文件时实例化新类，必须为类定义一个工厂。除非你的工厂需要做一些特别的事情，否则你可以从 中派生工厂。建议将工厂类放在组件类中。 Unity3D Unity3D ：创建自定义控件 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 创建自定义控件 若要创建自定义控件，必须创建自定义控件 C# 类并对其进行初始化。您可以公开它以在 UXML 中使用，并且用户界面 建筑工人。您还可以将其绑定到数据。 创建自定义控件类 创建派生自 VisualElement 类或该类的子类的 C# 类。例如，可以创建派生自 BaseField 泛型基类而不是 BindableElement 的可绑定自定义控件。这具有以下优点：VisualElement * 实现您指定的泛型参数类型的接口INotifyValueChanged * 默认情况下使控件可聚焦 * 提供水平布局，左侧是标签元素，右侧是输入 注意：如果您了解内置 UI 控件的内部层次结构和现有 USS 类，则可以创建从内置 UI 控件派生的自定义控件。Unity 不鼓励这种做法，因为您的自定义控件可能依赖于其内部结构，将来可能会发生变化。 初始化自定义控件 自定义控件继承自 。A Unity3D Unity3D ：使用 C# 脚本构建 UI 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 使用 C# 脚本构建 UI 技术用户可以定义布局用户界面 直接在 C# 中脚本 . 可以在 USS 文件中定义控件的外观，也可以在 C# 脚本中修改控件的样式属性。 控件是交互式的，表示可以更改的值。例如，a 表示浮点值。可以创建 C# 脚本来更改控件的值、注册回调或应用数据绑定。FloatField 使用 C# 脚本向 UI 添加控件 若要在 UI 中使用控件，请将其添加到可视化树 . 下面的示例将一个 Button 控件添加到现有的可视化树中。 var newButton = new Button("Click me!"); rootVisualElement.Add(newButton); 将控件添加到 Unity3D Unity3D ：使用 UQuery 查找视觉元素 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 使用 UQuery 查找视觉元素 您可以使用 UQuery 从可视化树 .UQuery 的灵感来自 JQuery 和 Linq，旨在限制动态内存分配。这允许在移动平台上获得最佳性能。 查询方法 您可以通过以下扩展方法使用 UQuery： * Q * Query 在内部，和方法使用 UQueryBuilder 来构造查询。这些扩展方法减少了创建 .QQueryUQueryBuilder 若要使用 UQuery 查找元素，必须先加载并实例化 UXML，然后在根上使用 或 构造选择规则QueryQ视觉元素 . Query返回与选择规则匹配的元素列表。您可以使用 UQueryBuilder 的公共方法过滤返回结果，例如 First、Last、AtIndex、Child 和 Where。Query Q是 的简写。 Unity3D Unity3D ：从 C# 脚本实例化 UXML 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 从 C# 脚本实例化 UXML 要构建用户界面 从 UXML 文件中，您必须首先将文件加载到 VisualTreeAsset 中，然后使用 Instantiate（） 在没有父级的情况下进行实例化，这将创建一个新的 ，或 CloneTree（parent）） 在父级中克隆。TemplateContainer 实例化 UXML 后，您可以从可视化树 与UQuery。 以下示例创建自定义编辑器窗口并加载 UXML 文件作为其内容： using UnityEditor; using UnityEngine; using UnityEngine.UIElements; using UnityEditor.UIElements; public class MyWindow : EditorWindow { [MenuItem ("Window/My Window" ← Newer Posts Page 15 of 51 Older Posts →
Unity3D Unity3D ：UXML 元素 FloatField 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML 元素 FloatField C# 类：浮点字段 命名空间：基类： TextValueField_1UnityEngine.UIElements 继承的属性 此元素从其基类继承以下属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。focusableboolean如果元素可以聚焦，则为 True。is-delayedboolean如果设置为 true，则在用户按 Enter 或文本字段失去焦点之前，不会更新 value 属性。labelstring表示将显示在字段旁边的标签的字符串。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。valuefloat这是字段的值。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名
Unity3D Unity3D ：UXML 元素 EnumFlagsField 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML 元素 EnumFlagsField C# 类：枚举标志字段 命名空间：基类： BaseMaskField_1UnityEditor.UIElements 继承的属性 此元素从其基类继承以下属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。focusableboolean如果元素可以聚焦，则为 True。labelstring表示将显示在字段旁边的标签的字符串。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。valuestring与字段关联的值。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。picking-modeUIElements.PickingMode确定是否可以在鼠标事件或查询期间选取此元素。I
Unity3D Unity3D ：UXML 元素 EnumField 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML 元素 EnumField C# 类：枚举字段 命名空间：基类： BaseField_1UnityEngine.UIElements 继承的属性 此元素从其基类继承以下属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。focusableboolean如果元素可以聚焦，则为 True。labelstring表示将显示在字段旁边的标签的字符串。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。valuestring与字段关联的值。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。picking-modeUIElements.PickingMode确定是否可以在鼠标事件或查询期间选取此元素。IPanel.Picks
Unity3D Unity3D ：UXML 元素 DropdownField 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML 元素 DropdownField 下拉字段允许用户从列表中选择一个值。单击控件时，它会打开一个抽屉，其中显示多个选项，允许用户选择一个选项。如果要始终显示所有选项，请使用单选按钮组。 响应用户操作 下拉字段响应更改事件。 您可以将 DropdownField 绑定到保存所选选项值的字符串变量。 在 UI 生成器中添加下拉列表字段的选项 若要为下拉列表字段添加选项，请在检查员 ，在“选项”中输入以逗号分隔的选项。 要设置默认值，请在“下拉字段”的检查器中，输入“索引”中选项的编号顺序，从 开始。0 在 C# 脚本中创建下拉列表字段 以下 C# 代码片段创建一个包含三个选项的下拉列表字段。默认情况下，下拉字段选择第一个选项。 var dropdown = new DropdownField("Options"
Unity3D Unity3D ：UXML元素DoubleField 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML元素DoubleField C# 类：双字段 命名空间：基类： TextValueField_1UnityEngine.UIElements 继承的属性 此元素从其基类继承以下属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。focusableboolean如果元素可以聚焦，则为 True。is-delayedboolean如果设置为 true，则在用户按 Enter 或文本字段失去焦点之前，不会更新 value 属性。labelstring表示将显示在字段旁边的标签的字符串。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。valuedouble这是字段的值。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称
Unity3D Unity3D ：UXML 元素 CurveField 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML 元素 CurveField C# 类：曲线字段 命名空间：基类： BaseField_1UnityEditor.UIElements 继承的属性 此元素从其基类继承以下属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。focusableboolean如果元素可以聚焦，则为 True。labelstring表示将显示在字段旁边的标签的字符串。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。picking-modeUIElements.PickingMode确定是否可以在鼠标事件或查询期间选取此元素。IPanel.Pickstylestring引用此元素的样式
Unity3D Unity3D ：UXML 元素色域 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML 元素色域 C# 类：色域 命名空间：基类： BaseField_1UnityEditor.UIElements 成员属性 此元素具有以下成员属性： 名字类型描述hdrboolean如果为 true，则将颜色视为高密度显示 价值。如果为 false，则将颜色视为标准 LDR 值。show-alphaboolean如果为 true，则允许用户设置颜色的 alpha 值。如果为 false，则隐藏 alpha 分量。show-eye-dropperboolean如果为 true，则颜色选取器将显示吸管控件。如果为 false，则颜色选取器不会显示吸管控件。 继承的属性 此元素从其基类继承以下属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。focusableboolean如果元素可以聚焦，则为 True。labelstring表示将显示在字段旁边的标签的字符串。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。
Unity3D Unity3D ：UXML 元素按钮 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML 元素按钮 使用 Button 元素在用户界面 .例如，当用户单击或点击 Button 元素时，它会触发操作或事件，例如打开新窗口、提交表单或播放声音效果。 使用按钮的子元素 可以使用按钮的 和属性向用户提供其他信息。如果您希望对这些元素的外观和行为进行更精细的控制，还可以在按钮的层次结构中添加子元素（如标签或图像），以便向用户提供其他信息。textbackground-image 通常，在以下情况下使用子元素： * 自定义：使用子元素可以单独自定义每个元素的外观和行为。例如，您可能希望对标签文本使用自定义字体或颜色，或者向图像添加特定动画。当您将图像元素添加到按钮时，您可以从现场 径直。此外，Image 元素还支持缩放模式和重复模式。 * 动态内容：如果标签或图像的内容是动态的，则使用子元素可以单独更新每个元素的内容，而不会影响按钮的其他属性。 * 交互：如果要为按钮中的特定元素添加交互性，例如允许用户仅单击标签（不考虑单击按钮的其他元素）以触发操作，则使用子元素可以
Unity3D Unity3D ：UXML 元素框 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML 元素框 C# 类：框 命名空间：基类： 视觉元素UnityEngine.UIElements 继承的属性 此元素从其基类继承以下属性： 名字类型描述focusableboolean如果元素可以聚焦，则为 True。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。picking-modeUIElements.PickingMode确定是否可以在鼠标事件或查询期间选取此元素。IPanel.Pickstylestring引用此元素的样式对象。 包含从 USS 文件或以 C# 写入此对象的内联样式计算的数据。tooltipstring用户将元素悬停一小段时间后要在信息框中显示的文本。usag
Unity3D Unity3D ：UXML element BoundsIntField 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML element BoundsIntField C# 类：BoundsIntField 命名空间：基类： BaseField_1UnityEngine.UIElements 继承的属性 此元素从其基类继承以下属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。focusableboolean如果元素可以聚焦，则为 True。labelstring表示将显示在字段旁边的标签的字符串。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。picking-modeUIElements.PickingMode确定是否可以在鼠标事件或查询期间选取此元素。IPanel.Pick
Unity3D Unity3D ：UXML 元素 BoundsField 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具链：NSDT简石数字孪生 UXML 元素 BoundsField C# 类：边界字段 命名空间：基类： BaseField_1UnityEngine.UIElements 继承的属性 此元素从其基类继承以下属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。focusableboolean如果元素可以聚焦，则为 True。labelstring表示将显示在字段旁边的标签的字符串。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。picking-modeUIElements.PickingMode确定是否可以在鼠标事件或查询期间选取此元素。IPanel.Pickstylestring引用此元素的样
Unity3D Unity3D ：UXML 元素 VisualElement 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 UXML 元素 VisualElement C# 类：可视元素 命名空间：基类： 可聚焦UnityEngine.UIElements 成员属性 此元素具有以下成员属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。picking-modeUIElements.PickingMode确定是否可以在鼠标事件或查询期间选取此元素。IPanel.Pickstylestring引用此元素的样式对象。 包含从 USS 文件或以 C# 写入此对象的内联样式计算的数据。tooltipstring用户将元素悬停一小段时间后要在信息框中显示的文本。usage-hintsUIElements.UsageHints提示值的组合，用于指定 的高级预期使用模式。仅当 尚未成为 的一部分时，才能设置此属性。一旦 的一部分，此属性将变为有效
Unity3D Unity3D ：UXML 元素 BindableElement 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 UXML 元素 BindableElement C# 类：可绑定元素命名空间：基类： 可视元素 UnityEngine.UIElements 成员属性 此元素具有以下成员属性： 名字类型描述binding-pathstring要绑定的目标属性的路径。 继承的属性 此元素从其基类继承以下属性： 名字类型描述focusableboolean如果元素可以聚焦，则为 True。tabindexint用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。 此元素还从可视元素继承以下属性： 名字类型描述content-containerstring子元素被添加到其中，通常这与元素本身相同。namestring此可视元素的名称。 使用此属性可以编写面向特定元素的 USS 选择器。标准做法是为元素指定一个唯一的名称。picking-modeUIElements.PickingMode确定是否可以在鼠标事件或查询期间选取此元素。IPanel.Pickstylestring引用此元素的样式对
Unity3D Unity3D ：使用逻辑封装 UXML 文档 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 使用逻辑封装 UXML 文档 一个预 置是预制的游戏对象您可以在现场.预制件对于创建可重用组件非常有用。视觉元素在用户界面工具包不是游戏对象，因此预制件不适用。但是，可以将自定义控件创建为可重用的 UI 组件，该组件使用逻辑封装元素的特定层次结构。由于 UI 工具包鼓励您将 UI 与游戏或应用程序代码分开，因此可以使用 UXML 定义结构，使用 USS 定义外观，并使用 C# 定义自定义控件的逻辑。 创建可重用的 UI 组件 创建可重用的 UI 组件，例如为卡片调用的自定义控件，该控件显示角色的图像以及生命和攻击统计信息，如下所示：CardElement 以下是完成此操作的一般步骤： 1. 在 C# 中，声明一个名为 CardElement 的自定义元素类型。 在
Unity3D Unity3D ：管理元素的最佳做法 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 管理元素的最佳做法 本页介绍在可视化树 . 预先创建层次结构 创建元素并将其加载到层次结构中是一项缓慢的操作。为了避免这种情况，您可以在层次结构中预先创建元素，并用于隐藏它们并仅在需要时显示它们。但是，同时创建多个元素可能会消耗更多内存。display:none 池重复元素 元素池化是为了保留以后可能会重新创建的元素，而不是每次都创建元素并放弃它们。new() 请务必完全控制池化的所有元素，并确保在将它们返回到池之前正确重置它们。否则，池化系统可能会变得不稳定和麻烦。例如，如果在注册事件回调或同时设置内部非序列化状态时池化元素，则无法清理元素。 保持少量可见元素 要保持数量视觉元素 低，尽可能使用列表视图。ListView 池化元素并在用户滚动时回收元素。 或者，您可以实现自己的池和回收机制，类似于 ListView，并使用以下命令来管理可见区域： * 要观察容器的大小，请使用 GeometryChangedEvent * 若要计算子级的大小，请使用 VisualElem
Unity3D Unity3D ：自定义 UXML 标记名称和属性 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 自定义 UXML 标记名称和属性 可以自定义 UXML 标记名称、重写基类属性的默认值或限制自定义控件的接受属性。 自定义 UXML 标签名称 默认情况下，自定义控件的 UXML 中的标记名称是 C# 类名称。不建议标记的名称与 C# 类的名称不同。但是，如果存在名称冲突，您可以自定义标记名称。 要自定义 UXML 标记名称，请覆盖其 和 属性。确保以下几点：IUxmlFactory.uxmlNameIUXmlFactory.uxmlQualifiedName * uxmlName在您的命名空间中是唯一的 * uxmlQualifiedName在您的项目中独一无二 如果两个名称都不唯一，Unity 会在加载程序集时引发异常。 下面的代码示例重写并自定义 UXML 标记名称： public class FactoryWithCustomName : UxmlFactory<..., ...> { public override
Unity3D Unity3D ：向 UXML 和 UI 生成器公开自定义控件 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 向 UXML 和 UI 生成器公开自定义控件 将自定义控件与 UXML 一起使用，并且用户界面 构建器，您必须公开它们。 定义工厂 若要定义新元素，请从 或其子类之一派生新类，然后在此新类中实现相应的功能。VisualElement 新类必须实现默认构造函数。例如： class StatusBar : VisualElement { public StatusBar() { m_Status = String.Empty; } string m_Status; public string status { get; set; } } 为了使 UI 工具包在读取 UXML 文件时实例化新类，必须为类定义一个工厂。除非你的工厂需要做一些特别的事情，否则你可以从 中派生工厂。建议将工厂类放在组件类中。
Unity3D Unity3D ：创建自定义控件 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 创建自定义控件 若要创建自定义控件，必须创建自定义控件 C# 类并对其进行初始化。您可以公开它以在 UXML 中使用，并且用户界面 建筑工人。您还可以将其绑定到数据。 创建自定义控件类 创建派生自 VisualElement 类或该类的子类的 C# 类。例如，可以创建派生自 BaseField 泛型基类而不是 BindableElement 的可绑定自定义控件。这具有以下优点：VisualElement * 实现您指定的泛型参数类型的接口INotifyValueChanged * 默认情况下使控件可聚焦 * 提供水平布局，左侧是标签元素，右侧是输入 注意：如果您了解内置 UI 控件的内部层次结构和现有 USS 类，则可以创建从内置 UI 控件派生的自定义控件。Unity 不鼓励这种做法，因为您的自定义控件可能依赖于其内部结构，将来可能会发生变化。 初始化自定义控件 自定义控件继承自 。A
Unity3D Unity3D ：使用 C# 脚本构建 UI 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 使用 C# 脚本构建 UI 技术用户可以定义布局用户界面 直接在 C# 中脚本 . 可以在 USS 文件中定义控件的外观，也可以在 C# 脚本中修改控件的样式属性。 控件是交互式的，表示可以更改的值。例如，a 表示浮点值。可以创建 C# 脚本来更改控件的值、注册回调或应用数据绑定。FloatField 使用 C# 脚本向 UI 添加控件 若要在 UI 中使用控件，请将其添加到可视化树 . 下面的示例将一个 Button 控件添加到现有的可视化树中。 var newButton = new Button("Click me!"); rootVisualElement.Add(newButton); 将控件添加到
Unity3D Unity3D ：使用 UQuery 查找视觉元素 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 使用 UQuery 查找视觉元素 您可以使用 UQuery 从可视化树 .UQuery 的灵感来自 JQuery 和 Linq，旨在限制动态内存分配。这允许在移动平台上获得最佳性能。 查询方法 您可以通过以下扩展方法使用 UQuery： * Q * Query 在内部，和方法使用 UQueryBuilder 来构造查询。这些扩展方法减少了创建 .QQueryUQueryBuilder 若要使用 UQuery 查找元素，必须先加载并实例化 UXML，然后在根上使用 或 构造选择规则QueryQ视觉元素 . Query返回与选择规则匹配的元素列表。您可以使用 UQueryBuilder 的公共方法过滤返回结果，例如 First、Last、AtIndex、Child 和 Where。Query Q是 的简写。
Unity3D Unity3D ：从 C# 脚本实例化 UXML 推荐：将NSDT场景编辑器加入你的3D工具链 3D工具集：NSDT简石数字孪生 从 C# 脚本实例化 UXML 要构建用户界面 从 UXML 文件中，您必须首先将文件加载到 VisualTreeAsset 中，然后使用 Instantiate（） 在没有父级的情况下进行实例化，这将创建一个新的 ，或 CloneTree（parent）） 在父级中克隆。TemplateContainer 实例化 UXML 后，您可以从可视化树 与UQuery。 以下示例创建自定义编辑器窗口并加载 UXML 文件作为其内容： using UnityEditor; using UnityEngine; using UnityEngine.UIElements; using UnityEditor.UIElements; public class MyWindow : EditorWindow { [MenuItem ("Window/My Window"
