Version: 2023.1

GameObjectUtility.GetUniqueNameForSibling

切换到手册
public static string GetUniqueNameForSibling (Transform parent, string name);

参数

parent GameObject 的目标父级。Null 表示根级。
name GameObject 的请求名称。

返回

stringGameObject 的唯一名称。

描述

可以在实例化一个新的同级之前或者在一个游戏对象与另一个游戏对象建立父子关系之前使用此方法,以确保新的子游戏对象与层级视图中的同级相比具有唯一的名称。

要使用此方法,必须提供“目标父项”和“请求的名称”。该方法使用附加到名称后的增量编号后缀来避免名称重复。

如果指定的目标父项还存在与指定的请求名称同名的子项,则该方法将返回请求的名称。如果目标父项“已经”具有与请求的名称匹配的子对象,则该方法将在请求的名称之后添加一个增量编号,直至找出一个唯一的名称。这对于尝试避免重复命名非常有用。

注意:应该在游戏对象成为目标父项的子项之前使用此方法。如果在游戏对象已经成为目标父项的子项之后使用此方法,则会在同级之间检测到游戏对象名称冲突!如果要在游戏对象成为目标父项的子项之后执行检查,则可以改用 GameObjectUtility.EnsureUniqueNameForSibling

另请参阅:GameObjectUtility.EnsureUniqueNameForSiblingObjectNames.GetUniqueName

Copyright © 2023 Unity Technologies
优美缔软件(上海)有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961