RadioButtonGroup

RadioButtonGroup を使用すると、ラジオボタンの論理的なグループから 1 つの選択肢を選択できるようになります。1 つを選択すると、他はキャンセルされます。RadioButtonGroup は DropdownField に似ていますが、RadioButtonGroup は UI にすべての選択肢を公開します。

ノート: 要素を Inspector ウィンドウの他のフィールドと揃えるには、.unity-base-field__aligned USS クラスを適用します。詳細については、BaseField を参照してください。

RadioButtonGroup を作成する

UI Builder、UXML、または C# で RadioButtonGroup を作成できます。

UI BUilder

UI Builder で RadioButtonGroup にオプションを加えるには、RadioButtonGroup の Inspector パネル内にある Choices フィールドに、選択肢をカンマで区切って入力します。

デフォルト値を設定するには、RadioButtonGroup の Inspector で、0 から始まるオプション番号シーケンスを Value に入力します。

C#

以下の C# の例では、4 つのオプションがある新しい RadioButtonGroup を作成して、その値変更コールバックに登録します。

var radiogroup = new RadioButtonGroup("Options", new List<string> { "Option 1", "Option 2", "Option 3", "Option 4" });
radiogroup.RegisterValueChangedCallback(evt => Debug.Log(evt.newValue));
window.rootVisualElement.Add(radiogroup);

例

以下の UXML 例では、RadioButtonGroup を作成します。

<UXML xmlns="UnityEngine.UIElements" xmlns:uie="UnityEditor.UIElements">
    <RadioButtonGroup label="UXML Field" name="the-uxml-field" />
</UXML>

以下の C# の例では、RadioButtonGroup のカスタマイズ可能な機能の一部を示しています。

/// <sample>
// You can provide the list of choices by code, or by comma separated values in UXML
// <DropdownField .... choices="Option 1,Option 2,Option 3" .... />
var choices = new List<string> { "Option 1", "Option 2", "Option 3" };

// Get a reference to the radio button group field from UXML and assign a value to it.
var uxmlField = container.Q<RadioButtonGroup>("the-uxml-field");
uxmlField.choices = choices;
uxmlField.value = 0;

// Create a new field, disable it, and give it a style class.
var csharpField = new RadioButtonGroup("C# Field", choices);
csharpField.value = 0;
csharpField.SetEnabled(false);
csharpField.AddToClassList("some-styled-field");
csharpField.value = uxmlField.value;
container.Add(csharpField);

// Mirror the value of the UXML field into the C# field.
uxmlField.RegisterCallback<ChangeEvent<int>>((evt) =>
{
    csharpField.value = evt.newValue;
});
/// </sample>

この例を Unity でライブ体験するには、Window > UI Toolkit > Samples の順に移動します。

C# クラスと名前空間

C# クラス: RadioButtonGroup
名前空間: UnityEngine.UIElements
基本クラス: BaseField_1

メンバー UXML 属性

この要素は以下のメンバー属性を持ちます。

継承された UXML 属性

この要素は基本クラスから以下の属性を継承します。

この要素は VisualElement から以下の属性も継承します。

USS クラス

以下の表は、すべての C# パブリックプロパティ名と、それに関連する USS セレクターのリストです。

Inspector または UI Toolkit Debugger の Matching Selectors セクション を使用して、階層のすべてのレベルで VisualElement のコンポーネントに影響する USS セレクターを確認することもできます。

追加リソース

• RadioButton