ListView を使わないでリストへバインドする
Version: 2023.2+
ListView を使わなくても、リストにバインドすることができます。そのためには、各要素をシリアル化されたオブジェクトの配列の項目にバインドし、配列のサイズの値を追跡します。配列のサイズは、元に戻す操作やリセットの操作など、特定の状況下で変化する可能性があります。
この例では、ListView を使わないでリストへバインドする方法を紹介します。
例の概要
この例は、TexturePreviewElements のリストを作成し、そのリストを Texture2D オブジェクトの基礎となるリストにバインドします。
You can find the completed files that this example creates in this GitHub repository.
要件
このガイドは、Unity エディター、UI Toolkit、および C# スクリプトに精通している開発者を対象としています。始める前に、以下をよく理解してください。
リストを含むオブジェクトを作成する
リストを含む C# クラスを作成します。このリストがバインディングのターゲットです。
- Unity で任意のテンプレートでプロジェクトを作成します。
- Project ウィンドウに、
bind-to-list-without-ListViewという名前のフォルダーを作成し、ファイルを保存します。 -
TexturePackAsset.csという名の C# スクリプトを作成し、そのコンテンツを以下に置き換えます。
カスタムコントロールの作成とスタイル設定
2D テクスチャアセットへの参照を表すカスタムコントロールを C# で作成し、USS でスタイルを設定します。
- フォルダーに
Editorという名前のフォルダーを作成します。 -
Editor フォルダーに、
TexturePreviewElement.csという C# スクリプトを作成します。 -
TexturePreviewElement.csの内容を以下に置き換えます。
-
Editor フォルダーに、
Resourcesという名前のフォルダーを作成します。 -
Resources フォルダーに
texture_preview_element.ussという名の StyleSheet を作成し、そのコンテンツを以下に置き換えます。
カスタムエディターを作成しバインディングを設定する
C# スクリプトでカスタムエディターを作成し、アセットを作成します。
UI の TexturePreviewElements の数が変わるときにテクスチャリストのサイズを変更するには、SetupList() メソッドを呼び出し、シリアル化されたリストのエントリを走査します。
各 TexturePreviewElement をテクスチャのリストにバインドするには、BindProperty() を TexturePackAsset.textures のプロパティ名で呼び出します。
-
Editor フォルダーに、
TexturePackEditor.csという名の C# スクリプトを作成し、そのコンテンツを以下と置き換えます。
-
texture_pack_editor.uxmlという名の UI ドキュメントを作成し、そのコンテンツを以下に置き換えます。
- Project ウィンドウで TexturePackEditor.cs を選択します。
- Inspector で texture_pack_editor.uxml を ビジュアルツリーアセット にドラッグします。
バインディングのテスト
- メニューから、Assets > Create > UIToolkitExamples > TexturePackAsset を選択してください。これで、 New Texture Pack Asset という名前のアセットが作成されます。
- Project ウィンドウで New Texture Pack Asset を選択します。これにより、Inspector に 4 つの TexturePreviewElement 要素が表示されます。
- これらの要素に 2D イメージアセットを割り当てるか、 Add (追加) ボタンを使用して新しい要素を追加します。Inspector UI で変更を加えると、
TexturePackAsset.texturesオブジェクトのプロパティが変更されます。
****ヒント**: いくつかのテクスチャをインポートして、リストの異なるエントリに割り当てるには、この無料の Playground プラグイン を利用してください。