Version: 2022.3

GameObjectUtility.GetUniqueNameForSibling

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

参数

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

返回

stringGameObject 的唯一名称。

描述

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

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

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

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

另请参阅:GameObjectUtility.EnsureUniqueNameForSiblingObjectNames.GetUniqueName