TMP Dropdown

TMP_Dropdown は、クリックすると選択肢のリストを表示し、その中から一つを選択できる標準的なドロップダウンです。Unity のレガシーな UI.Dropdown コンポーネントの代わりに、常にこちらを使用してください。

Properties

Property	Type	Description
`value`	`int`	ドロップダウン内で選択されている要素のインデックスを取得または設定します。
`IsExpanded`	`bool`	ドロップダウンが展開されているかどうかを示す値を取得します。
`enable`	`bool`	アタッチされたコンポーネントの有効/無効を切り替えます。

Function	Input	Output	Description
`SetValueWithoutNotify`	`int`	`void`	`onValueChanged` を呼び出さずに、入力フィールドの値を設定します。
`RefreshShownValue`			現在選択されているオプションのテキストと画像（存在する場合）を更新します。
`ClearOptions`			ドロップダウンからすべてのオプションを削除します。
`Show`			ドロップダウンを表示します。画面内にドロップダウンが収まるよう、スクロールを考慮して配置してください。TMPは、Canvasをドロップダウンが収まるべき画面領域として想定しています。
`Hide`			ドロップダウンリストを非表示にします。

Udonでは、TMP_Dropdownに関連する2つの追加クラスを利用できます。

このクラスはVRChat SDKの一部です。ドロップダウンにオプションを追加するために使用します。

Function	Input	Description
`AddOptions`	TMP_Dropdown, string[]	文字列の配列をドロップダウンに追加します。
`AddOptions`	TMP_Dropdown, sprite[]	スプライトの配列をドロップダウンに追加します。
`AddOptions`	TMP_Dropdown, OptionData[]	Adds the array of TMP_Dropdown.OptionData to the dropdown.

Extension method

UdonSharpにおいて、AddOptionsは拡張メソッドです。

AddOptions(dropdown, options) の代わりに、dropdown.AddOptions(options) と記述することもできます。ファイル内に VRC.SDK3.Components 名前空間が含まれていることを確認してください。

これは TextMesh Pro に組み込まれています。これにより、文字列とスプライトを組み合わせてドロップダウンに追加できます。

Functions	Input	Output	Description
`Constructor`	`string`	`OptionData`	テキストをオプションとして持つ OptionData オブジェクトを作成します。
`Constructor`	`sprite`	`OptionData`	スプライトをオプションとして持つ OptionData オブジェクトを作成します。
`Constructor`	string, sprite	`OptionData`	テキストとスプライトをオプションとして持つ OptionData オブジェクトを作成します。