GroupBox

GroupBox は、複数のビジュアル要素の論理グループのためのコンテナ要素です。同じパネルに複数のオプショングループを持たせる場合は、GroupBox と RadioButton を組み合わせて使用できます。

ラジオボタンのグループを 1 つのフィールドとして扱う場合は、RadioButtonGroup を使用します。ほとんどの場合、RadioButtonGroup を使用することをお勧めします。これは、GroupBox と RadioButton を組み合わせて使用する場合は、すべてのラジオボタンを登録する必要があるためです。ただし、グループにビジュアル要素を追加したい場合は、この組み合わせを使用します。

2 つのラジオボタン、1 つの入力テキストフィールド、1 つのボタンを持つグループボックス。

C# スクリプトで GroupBox を作成する

以下の C# コードスニペットは、GroupBox を作成し、論理的にグループ化されるように 3 つのラジオボタンを追加します。

var group = new GroupBox("Group Example");
// Must register change events on each radio button.
var choice1 = new RadioButton("First Choice");
choice1.RegisterValueChangedCallback(v => Debug.Log("Choice 1 is : " + v.newValue));
var choice2 = new RadioButton("Second Choice");
choice2.RegisterValueChangedCallback(v => Debug.Log("Choice 2 is : " + v.newValue));
var choice3 = new RadioButton("Third Choice");
choice3.RegisterValueChangedCallback(v => Debug.Log("Choice 3 is : " + v.newValue));
group.Add(choice1);
group.Add(choice2);
group.Add(choice3);
rootVisualElement.Add(group);

C# クラスと名前空間

C# クラス: GroupBox
名前空間: UnityEngine.UIElements
基本クラス: BindableElement

メンバー UXML 属性

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

名前	型	説明
`text`	`string`	ボックスのタイトルテキスト。

継承された UXML 属性

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

名前	型	説明
`binding-path`	`string`	バインドするターゲットプロパティのパス。	`focusable`	`boolean`	要素がフォーカス可能である場合は true。
`tabindex`	`int`	フォーカスリング内でフォーカス可能な対象をソートするために使用される整数。0 以上の値に設定する必要があります。

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

名前	型	説明
`content-container`	`string`	子要素が追加されますが、通常は子要素は要素自体と同じです。
`data-source`	`Object`	継承されたデータソースをオーバーライドするこの VisualElement にデータソースを割り当てます。このデータソースはすべての子に継承されます。
`data-source-path`	`string`	データソースから値へのパス。
`data-source-type`	`System.Type`	この VisualElement に割り当て可能なデータソースの型。この情報は、設計時に有効なデータソースを指定できない場合に、データソースパスフィールドを補完するヒントとして UI Builder でのみ使用されます。
`language-direction`	`UIElements.LanguageDirection`	要素のテキストの向きを示します。値は要素の子に伝播されます。 languageDirection を RTL に設定すると、テキストの反転と改行/折り返しの適切な処理による、右から左へ (RTL) の基本サポートが追加されます。ただし、包括的な RTL サポートは提供されません。これには、文字の並べ替えを含むテキストシェーピングと OpenType フォント機能のサポートが必要になるためです。将来のアップデートでは、言語、スクリプト、フォント機能の仕様を処理するための追加の API を含む、包括的な RTL サポートが予定されています。このプロパティの RTL 機能を拡張するには、Unity Asset Store で入手可能なサードパーティ製のプラグインを探し、`ITextElementExperimentalFeatures.renderedText` を利用してください。
`name`	`string`	この VisualElement の名前。このプロパティを使用して、特定の要素を対象とする USS セレクターを記述します。要素には一意の名前を付けるのが標準的です。
`picking-mode`	`UIElements.PickingMode`	mouseEvent または `IPanel.Pick` クエリの間にこの要素を選択 (ピック) できるかどうかを決定します。
`style`	`string`	`VisualElement` スタイルの値を設定します。
`tooltip`	`string`	ユーザーが要素をマウスオーバーした後、わずかな時間、情報ボックス内に表示するテキスト。これはエディター UI でのみサポートされます。
`usage-hints`	`UIElements.UsageHints`	`VisualElement` の意図されている使用パターンの概要を指定するヒント値の組み合わせ。このプロパティは、`VisualElement` がまだ `Panel` の一部でない場合にのみ設定できます。`Panel` の一部になると、このプロパティは事実上読み取り専用となり、変更しようとすると例外がスローされます。適切な `UsageHints` を指定することで、予想される使用パターンに基づいて、特定の操作をどのように処理するか、または高速化するかについて、システムがより適切な判断を下すようになります。これらのヒントは動作や視覚的な結果には影響せず、パネルとその中の要素の全体的なパフォーマンスにのみ影響することに注意してください。常に適切な `UsageHints` を指定することを考慮するようお勧めしますが、特定の条件下 (例: ターゲットプラットフォームのハードウェア制限) では、一部の `UsageHints` が内部的に無視される可能性があることに留意してください。
`view-data-key`	`string`	ビューデータの永続性 (ツリーの展開状態、スクロール位置、ズームレベルなど) に使用されます。このキーは、ビューデータストアからビューデータを保存およびロードするために使用されます。このキーを設定しないと、関連する `VisualElement` の永続性が無効になります。詳細については、ビューデータの永続性を参照してください。

USS クラス

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

C# プロパティ	USS セレクター	説明
`ussClassName`	`.unity-group-box`	GroupBox 要素の USS クラス名。 Unity はこの USS クラスを GroupBox 要素のすべてのインスタンスに追加します。このクラスに適用されるスタイルは、ビジュアルツリーのスタイルシートの横または下にあるすべての GroupBox に影響します。
`labelUssClassName`	`.unity-group-box__label`	GroupBox 要素のラベルの USS クラス名。 GroupBox にラベルがある場合、Unity はこの USS クラスを `GroupBox` の `Label` サブ要素に追加します。
`disabledUssClassName`	`.unity-disabled`	ローカルで無効に設定されている要素の USS クラス名

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

追加リソース

GradientField

Hash128Field

Unity マニュアル