Version: 2017.3

PrefabUtility.FindRootGameObjectWithSameParentPrefab

マニュアルに切り替える
public static GameObject FindRootGameObjectWithSameParentPrefab (GameObject target);

パラメーター

destinationScene シーンにプレハブをインスタンス化します

戻り値

GameObject プレハブのルートとなるゲームオブジェクト。

説明

target と同じプレハブ親を持つ最上位のゲームオブジェクトを返します

プレハブは、内部的には、1 つのプレハブオブジェクトとプレハブに使われる複数オブジェクトのリストで構成されています。プレハブオブジェクトはルートのゲームオブジェクトを指すポインターを所有しています。そのプレハブがインスタンスである場合は、それが作成されたアセットを指すポインターとそのインスタンスに対して行われた修正のリストも所有しています。

プレハブのインスタンスオブジェクトか、プレハブから切断されたオブジェクトが使用されるときに、有効な結果のみを返します。

この関数は入力されたオブジェクトと関連するトランスフォームを探します。トランスフォームが同じプレハブアセットを元にインスタンス化されている限り、トランスフォームツリーの根元に向かって検索します。プレハブアセットのルートゲームオブジェクトのトランスフォームと一致するものを見つけると、検索を止めそのゲームオブジェクトのインスタンスを返します。

PrefabUtility.FindPrefabRoot と似ていますが、この関数はプレハブが切断されている場合にも利用できます。切断されたプレハブのインスタンスオブジェクトをプレハブアセットに再接続したい場合は、この関数が役立ちます。

This returns a valid result when a prefab instance object, or an object that has been disconnected from a prefab, is used. This function finds the transform associated with the input object. It will the walk up the ancestors of the transform tree as long as the transform was instantiated from the same prefab asset. Once it reaches the transform that matches the transform on the root game object of the prefab asset it will stop and returns the game object instance. This is similar to FindPrefabRoot but it also works if the prefab instance has been disconnected. This is useful if you have a disconnected prefab instance object and you want to reconnect it to the prefab asset.