Unity3D ：UXML 元素图像
推荐：将NSDT场景编辑器加入你的3D工具链
3D工具集：NSDT简石数字孪生
UXML 元素图像
使用 Image 元素将图形资产添加到应用程序中。这是一个多功能且功能强大的工具，用于在您的用户界面
，例如图片库、产品列表、渲染预览和用户配置文件。
创建镜像
必须使用 UXML 或 C# 代码在 UI 中添加图像元素，并将图像源提供给 --unity-image USS 自定义属性。
您可以使用 --unity-image-size USS 自定义属性设置图像缩放模式。您还可以使用 --unity-image-tint-color USS 自定义属性设置图像色调颜色。
以下 UXML 示例使用内联样式添加图像源：
<ui:Image style="--unity-image: url('path/to/image');"/>
您可以设置 Image 元素的大小和布局，以及元素中图像的大小和布局。这允许您控制图像在 UI 中的显示方式，例如调整图像大小以适应特定区域或将其与其他 UI 元素对齐。您还可以向 Image 元素添加交互性，例如允许用户单击或点击图像以触发操作。可以将样式应用于 Image 元素和图像本身，例如调整不透明度或应用滤色器。
图像与VisualElement.backgroundImage
可以使用 Image 元素和属性向 UI 添加视觉对象内容。两者之间的选择取决于应用程序的特定用法和要求。VisualElement.backgroundImage
Image 元素通常用于显示 UI 特定区域内的图像，例如图像库或化身
在用户配置文件中。它提供了对图像外观的更精细的控制，包括用于调整大小、缩放和裁剪的选项。如果您希望图像的大小来驱动布局中元素的大小，请使用 Image。您还可以向 Image 元素添加其他元素以创建叠加或添加交互性。但是，出于性能原因，如果使用多个 Image 实例，请指定固定的宽度和高度。
该属性用于将图像设置为 UI 元素的背景。当您想要在不减损 UI 的主要内容或功能的情况下向元素添加视觉趣味时，这非常有用。该属性还允许方便地使用 USS 更改许多不同元素的源图像。VisualElement.backgroundImageVisualElement.backgroundImage
通常，当您需要更好地控制图像的外观和布局时，建议使用 Image 元素;并在只想将背景图像添加到 UI 元素时使用该属性。但是，这两种方法都是有效的，如有必要，可以在同一 UI 中一起使用它们。VisualElement.backgroundImage
注：
- Image 元素还支持该属性。如果 Image 元素设置了图像源且背景图像不透明，则背景图像将不可见。
backgroundImage - UI 生成器部分支持图像元素。它读取和写入 UXML，并允许将基本创作作为标准视觉元素
.大多数特定于映像的设置都定义为 USS 自定义属性，在 UI 生成器的“属性”部分中不可见检查员
.
C# 基类和命名空间
C# 类：图像
命名空间：基类：视觉元素UnityEngine.UIElements
继承的属性
此元素从其基类继承以下属性：
| 名字 | 类型 | 描述 |
|---|---|---|
focusable | boolean | 如果元素可以聚焦，则为 True。 |
tabindex | int | 用于对焦点环中的可聚焦对象进行排序的整数。必须大于或等于零。 |
此元素还从可视元素继承以下属性：
| 名字 | 类型 | 描述 |
|---|---|---|
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-image | 此类型元素的 USS 类名。 |
disabledUssClassName | .unity-disabled | 本地禁用元素的 USS 类名。 |
USS 自定义属性
下表概述了专用于 USS 中的 Image 元素的自定义属性：
| 财产 | 类型 | 描述 |
|---|---|---|
--unity-image | 字符串 | 图像文件的源。有关如何引用图像资源的信息，请参阅资产. |
--unity-image-size | 字符串 | 图像缩放模式。可用值为 、 和 。stretch-to-fillscale-and-cropscale-to-fit |
--unity-image-tint-color | 字符串 | 图像色调颜色。 |
由3D建模学习工作室整理翻译，转载请注明出处！