UI Toolkit：UIツリーが再構築されるタイミング

1. スクリプトやコードで明示的に再ロードした場合

以下の操作を行った場合、UIDocument 内の UI ツリーが再生成されます：

• VisualTreeAsset を再設定した場合
  UIDocument.visualTreeAsset プロパティに新しい VisualTreeAsset を設定すると、UI ツリーが再構築されます。

例：

var newVisualTree = Resources.Load<VisualTreeAsset>("NewUI");

GetComponent<UIDocument>().visualTreeAsset = newVisualTree;

• UIDocument コンポーネントを有効化/無効化した場合
  Unity のコンポーネントの有効化/無効化 (SetActive(false) → SetActive(true) や、enabled プロパティの切り替え) によっても、UIDocument が再初期化されます。

2. ゲームオブジェクトが破棄・再生成された場合

UIDocument がアタッチされているゲームオブジェクトが破棄されたり、非アクティブ化→再アクティブ化されたりした場合も再ロードが発生します。

例：

gameObject.SetActive(false);

gameObject.SetActive(true);

3. シーンのリロード

シーンのリロードによって、シーン内のすべてのオブジェクトが再生成されます。この場合、UIDocument も含めて UI の状態が初期化されます。

例：

SceneManager.LoadScene(SceneManager.GetActiveScene().name);

4. Play Mode の再開

Unity エディタで Play Mode を一旦停止し、再度開始した場合、すべてのコンポーネントが再初期化されるため、UIDocument も再ロードされます。

5. Editor ウィンドウの操作

エディタ上で以下の操作を行うと、再ロードがトリガーされる場合があります：

• UIDocument に関連するアセット（VisualTreeAsset や StyleSheet）を更新した場合。

• インスペクタ上で UIDocument のプロパティを変更した場合。

6. 動的に削除/追加した場合

スクリプトやユーザー操作で、UIDocument をアタッチしたゲームオブジェクトを動的に削除し、新たに生成した場合。

例：

Destroy(gameObject);

// 新しいオブジェクトを生成して UIDocument を再アタッチ

var newGameObject = new GameObject("NewUIDocument");

newGameObject.AddComponent<UIDocument>();

再ロードが起きたかの確認方法

再ロードが発生した場合、rootVisualElement の参照が変わります。以下のようにチェックすることで再ロードの発生を確認できます。

private VisualElement cachedRoot;

void Start()

{

    var root = GetComponent<UIDocument>().rootVisualElement;

    cachedRoot = root;

}

void Update()

{

    var currentRoot = GetComponent<UIDocument>().rootVisualElement;

    if (!ReferenceEquals(cachedRoot, currentRoot))

    {

        Debug.Log("UIDocument has been reloaded.");

        cachedRoot = currentRoot;

    }

}

結論

通常の運用では UIDocument の再ロードは頻繁には起こりませんが、動的な UI の切り替えやオブジェクトのアクティブ化/非アクティブ化が絡む場合に注意が必要です。再ロードが発生する可能性のある状況を把握しておくと、意図しない UI の挙動を防ぐことができます。