简介

使用 检视窗口（Inspector）可对 SandMod 编辑器中几乎所有内容（包括游戏对象、UI 对象、资产、节点等）进行查看和设置、编辑属性。它包含选中内容的名称，并且一般还会包含一个或多个可折叠的类目，用于组织其中所包含的属性。选中 游戏对象（Game Object）时还会显示包含一个或多个可折叠类目的组件。

【SandMod_Basics_Inspector001.png】

编辑器默认布局下，检视窗口（Inspector）停放在 SandMod 编辑器窗口的右侧。点击查看大图。

显示检视窗口

在 SandMod 编辑器的默认布局下，所有子编辑器都会有 检视窗口（Inspector），如果没有显示或窗口消失，您可以在 菜单栏（Menu）中点选 窗口（Window） > 视图（Panel） > 检视窗口（Inspector） 进行显示。

【SandMod_Basics_Inspector002.png】

检视窗口构成

因为您在编辑器中选中不同的资产或游戏对象（Game Object）、UI 对象（UI Object）、节点时，检视窗口显示的内容都会有较大的差别，因此这里以选中 游戏对象 时 检视窗口 显示的属性为例，主要用于展示 检视窗口 的主要构成元素。当您在场景编辑器中选中一个立方体 游戏对象 时，检视窗口将会显示以下内容：

【SandMod_Basics_Inspector003.png】

1. 组件（Component），游戏对象 显示在 检视窗口特有的功能，关于组件的创建、编辑和使用方法，请查阅 组件 章节。
2. 可折叠类目（Collapsible Categories），用于给相关属性分组，可使用名称左边的白色小三角展开及折叠。
3. 属性条目（Properties），具体的属性项。

检视内容

可以在 检视窗口 中查看和编辑的内容取决于所选择的内容。本部分介绍可以选中并在 检视窗口 查看的不同类型内容，检视窗口 所显示的属性和信息。

检视游戏对象

您选中 游戏对象时（例如在 层级窗口 或 场景预览窗口 中选中），检视窗口 会显示其默认属性、所有组件和材质的属性，可以在 检视窗口 中编辑属性和重新排列组件。关于检视游戏对象更多信息，请参阅 场景编辑器检视窗口 章节。

【SandMod_Basics_Inspector004.png】

检视 UI 对象

在 UI 编辑器内，您在 UI 编辑器 的 层级窗口 或者 UI 画布窗口 中选中 UI 对象 时，检视窗口 会显示每个 UI 对象 专属的属性和功能。关于检视 UI 对象更多信息，请参阅 UI 编辑器检视窗口 章节。

【SandMod_Basics_Inspector005.png】

检视资产

选择 资产（Asset）时（例如通过 项目窗口 选中），检视窗口 会显示资产的属性和 SandMod 引擎引用资产的设置。

【SandMod_Basics_Inspector006.png】

每种类型的资产都有自己的属性，您可以参阅 资产 章节查询资产类型，并跳转特定类型查看其可编辑或者可查看的属性。

检视状态节点与状态连线

在 动画控制器 内，您在 状态机窗口（Animator） 中选中状态节点或者状态连线时，检视窗口 会显示对应的属性。关于检视状态节点与状态连线更多信息，请参阅 状态机 和 过渡规则 章节。

【SandMod_Basics_Inspector007.png】

批量操作

选择了两个或更多内容（资产或游戏对象、UI 对象）时，可以在 检视窗口 中编辑它们共有的所有属性。SandMod 编辑器会将修改的属性值复制到所选的内容中。

多个对象（游戏对象或 UI 对象）

选择多个对象时，检视窗口 会显示它们共有的所有组件或可折叠类目。

• 对于在两个或更多选定对象中不同的属性值，检视窗口 会显示 " - "。

【SandMod_Basics_Inspector008.png】

• 对于在所有选定对象中相同的属性值，检视窗口 会显示实际值。

【SandMod_Basics_Inspector009.png】

• 如果任何选定对象具有其他选定对象上不存在的组件或可折叠类目，则 检视窗口 隐藏该组件或可折叠类目。

【SandMod_Basics_Inspector010.png】

多个资产

选择相同类型的多个资产时，检视窗口 会显示它们共有的所有属性。

• 对于在所有选定资产中相同的属性值，检视窗口 会显示实际值。

【SandMod_Basics_Inspector011.png】

• 对于在两个或更多选定资产中不同的属性值，检视窗口 会显示 " - "。

【SandMod_Basics_Inspector012_1.png】

• 对于选中两个或更多不同类型的资产，检视窗口 会显示选中资产的数量。

【SandMod_Basics_Inspector012_2.png】

属性值类型

属性分为以下主要类型：

• 引用，引用其他游戏对象和资产的链接框。
• 值，如数字、颜色、开/关设置、文本等。

引用类型属性

引用类型的属性条目将场景中兼容的项目资产或游戏对象作为输入。

可通过将对象和资产拖放到引用属性框内，或是使用引用列表，将引用的资产或对象指定给属性条目。

一些引用属性接受特定类型的组件，如 转换组件（Transform Component）。将游戏对象分配给这些属性时，SandMod 会在游戏对象上找到所需类型的第一个组件，并将它指定给引用的属性条目。如果游戏对象没有任何具有正确类型的组件，则无法将该游戏对象指定给属性条目。

通过拖动指定引用

要将引用的资产或游戏对象指向属性条目，请将兼容的资产或游戏对象拖放到 检视窗口 中对应的属性条目引用框内。

【SandMod_Basics_Inspector013.png】

使用引用列表指定引用

使用引用列表查找并选择要指向的引用资产或游戏对象。

单击对应属性条目引用框右侧的同心圆图标，即可打开引用列表。找到要引用的游戏对象或资产，鼠标指向它并点击左键，即可引用该游戏对象或资产指向属性条目。

【SandMod_Basics_Inspector014.png】

值类型属性

文本（String）

您可以在文本类型的属性条目中输入文本和数值，但是该属性最终输出的都是字符串格式（String）。

【SandMod_Basics_Inspector015.png】

数值（Number）

可以在数值类型的属性条目中输入整型或浮点型数值，该数值框最终输出数值格式（Number）。

【SandMod_Basics_Inspector016.png】

关于数值类型的属性条目还有以下两种特殊编辑功能：

• 将鼠标指向数值框，长按鼠标左键并左右拖动鼠标，属性值会根据鼠标拖动的方向和幅度增大或减小属性数值。

【SandMod_Basics_Inspector017.gif】

• 数值框支持自然表达式输入，当输入自然表达式后点击回车，会直接在数值框中显示计算结果。

【SandMod_Basics_Inspector018.gif】

滑动条（Sliders）

部分属性具有用于调整数值的滑动条，其本质是一个数值类型的属性条目，只是通过装饰器以滑动条的形式规定了数值的最大值和最小值，方便您的编辑。

【SandMod_Basics_Inspector019.png】

布尔值（Boolean）

在布尔值类型的属性条目中以复选框的形式来编辑。

选中状态表示属性值为 True。

非选中状态表示属性值为 False。

【SandMod_Basics_Inspector020.png】

向量（Vector）

向量分为 二维向量（Vector 2）、三维向量（Vector 3）和四维向量（Vector 4） 三种。

向量类型的属性条目中，属性值是通过 2 至 4 个数值框组合在一起编辑，并且输入框上会以 x、y 、z、w 标识每个数值对应的子属性名。

【SandMod_Basics_Inspector021.png】

关于向量类型的属性条目，鼠标指向该类型条目后点击右键，可以直接 复制（Copy） 整个属性条目的向量值，将鼠标指向同样类型的向量属性条目后，按鼠标右键进行 粘贴（Paste） ，可以将整个向量复制到新属性条目中，无需复制每个子属性。

【SandMod_Basics_Inspector022.gif】

颜色值（Color）

颜色类型的属性条目会以颜色预览框展示其颜色值对应的颜色。

【SandMod_Basics_Inspector023.png】

点击颜色属性预览框，会弹出 调色板窗口，在这个窗口里可以用鼠标直接点选需要的颜色，或在 调色板窗口 的 RGBA 数值、HSVA 数值、十六进制（Hexadecimal） 输入框中直接输入指定颜色的属性数值。

【SandMod_Basics_Inspector024.png】

点击 调色板窗口 以外的任何位置会关闭窗口，并以最后选定的颜色作为属性值。关于 调色板窗口 的更多使用方法和颜色编辑方法，请查阅 调色板 章节。

数组（Arrays）

检视窗口将会以可折叠类目的方式显示，提供编辑数组中的 项数 (Size) 以及其中的值或引用的功能。

【SandMod_Basics_Inspector025.png】

几何体的 网格渲染器（MeshRenderer）组件中的材质数组就是数组类型的属性类型。

当降低 项数（Size）的值时，会优先从数值的末尾元素开始移除。 提高 项数（Size）值时，数组将从末尾创建新元素。

枚举（Enum）

以下拉菜单的形式编辑，点击枚举菜单，然后从弹出的菜单列表里选择一项，即可完成枚举值的修改。

【SandMod_Basics_Inspector026.png】

回退默认值

当属性被修改为其默认值以外的值时，将显示一个指示器。

【SandMod_Basics_Inspector027.png】

通过单击 指示器， 可以将该属性条目重置为默认值。

【SandMod_Basics_Inspector028.png】

属性条目的值被重置为默认值，如菜单所示，指示器将不再显示。

【SandMod_Basics_Inspector029.png】

编辑条件

有编辑条件的属性依赖于另一个变量的值（布尔值类型的属性为不同的值，或者枚举类型的属性选取不同的值）来确定它们是否启用、可否进行编辑。

在某些情况下，编辑条件用于确定属性是否会覆盖某些其他值，或者是否有任何影响。其他时候，除非满足某些条件，否则某些属性可能根本没有意义。

-------------- 例如，在场景中控制灯光的 Light 游戏对象，选中它后在 检视窗口 显示它有一个命名为 类型（Type）的属性，一般情况下它的 类型（Type）属性条目的值是 平行光（Directional），光照范围（Rang）的属性是没有启用的，在检视窗口也不显示。 【SandMod_Basics_Inspector030.png】 但是如果将它的 类型（Type）属性条目的值设置为 点光源（Point），光照范围（Rang）的属性将会启用，在检视窗口中显示并可以编辑。 【SandMod_Basics_Inspector031.png】 --------------

常量属性

部分属性不能在编辑器中修改它们的值，并置灰以表明它们不能编辑。但是该属性的数值会在项目 运行（Play）时因某些条件而发生变化，可用于查看某些运行的信息。

【SandMod_Basics_Inspector032.png】

游戏项目运行前，该属性置灰。

【SandMod_Basics_Inspector033.png】

游戏运行时，该属性随对应的游戏对象运动而变化。