RadioButtons クラス

定義

名前空間:

Microsoft.UI.Xaml.Controls

選択できる関連オプションのグループを示すコントロールを表します。

このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Items")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class RadioButtons : Control

[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Items")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class RadioButtons : Control

Public Class RadioButtons
Inherits Control

継承

Control

RadioButtons

属性

Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute ContentPropertyAttribute ContractVersionAttribute

例

ヒント

詳細、設計ガイダンス、およびコード例については、「 ラジオ ボタン」を参照してください。

WinUI 2 ギャラリー アプリを開き、RadioButton の動作を確認します。

WinUI 2 ギャラリー アプリには、ほとんどの WinUI 2 コントロールと機能の対話型の例が含まれています。 Microsoft Store からアプリを入手するか、GitHub でソース コードを取得します。

注釈

詳細、設計ガイダンス、およびコード例については、「 ラジオ ボタン」を参照してください。

オプション ボタンとも呼ばれるラジオ ボタンを使用して、ユーザーが 2 つ以上の相互に排他的だが関連するオプションのコレクションから 1 つのオプションを選択できるようにします。 ラジオ ボタンは常にグループで使用され、各オプションはグループ内の 1 つのラジオボタンで表されます。

コントロールは RadioButtons 、レイアウトを簡略化し、キーボード ナビゲーションとアクセシビリティを処理し、データ ソースへのバインドをサポートします。 RadioButtons を使用する場合、オプションのグループは、個々の RadioButton コントロールを追跡するのではなく、1 つのエンティティとして扱うことができます。

RadioButtons コントロールでは、ItemsControl に似たコンテンツ モデルが使用されます。 そのため、以下を行うことができます。

• 項目を Items コレクションに直接追加するか、データをその ItemsSource プロパティにバインドすることにより事前設定する。
• SelectedIndex または SelectedItem プロパティを使用して、選択されているオプションの取得および設定を行う。
• SelectionChanged イベントを処理して、オプションが選択されたときにアクションを実行する。

コントロールのスタイルとテンプレート

既定の スタイル と ControlTemplate を変更して、コントロールに一意の外観を与えることができます。 コントロールのスタイルとテンプレートの変更については、「 XAML スタイル」を参照してください。 コントロールの外観を定義する既定のスタイル、テンプレート、およびリソースがファイルに generic.xaml 含まれます。 設計上の目的で、 generic.xaml は WinUI (Microsoft.UI.Xaml) NuGet パッケージと共にインストールされます。 既定では、この場所は \Users\<username>\.nuget\packages\microsoft.ui.xaml\<version>\lib\uap10.0\Microsoft.UI.Xaml\Themes\generic.xaml です。 WinUI の異なるバージョンのスタイルとリソースの値が異なる場合があります。

XAML には、コントロール テンプレートを変更せずに、さまざまなビジュアル状態のコントロールの色を変更するために使用できるリソースも含まれています。 これらのリソースを変更することは、 Background や Foreground などのプロパティを設定する場合に適 しています。 詳細については、XAML スタイルに関する記事の「軽量スタイル設定」セクションを参照してください。

コンストラクター

RadioButtons()

RadioButtons クラスの新しいインスタンスを初期化します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

プロパティ

Header	グループ ヘッダーの内容を取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
HeaderProperty	Header 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
HeaderTemplate	コントロールのヘッダーの内容を表示するために使用するデータ テンプレートを取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
HeaderTemplateProperty	HeaderTemplate 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
Items	コントロールの内容を生成するために使用されるコレクションを取得します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
ItemsProperty	Items 依存関係プロパティを識別 します 。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
ItemsSource	コントロールのコンテンツの生成に使用するオブジェクト ソースを取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
ItemsSourceProperty	ItemsSource 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
ItemTemplate	各項目の表示に使用する DataTemplate を取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
ItemTemplateProperty	ItemTemplate 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
MaxColumns	ラジオ ボタンを配置する列の最大数を取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
MaxColumnsProperty	MaxColumns 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
SelectedIndex	選択したラジオ ボタンのインデックスを取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
SelectedIndexProperty	SelectedIndex 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
SelectedItem	選択したラジオ ボタンを取得または設定します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。
SelectedItemProperty	SelectedItem 依存関係プロパティを識別します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

メソッド

ContainerFromIndex(Int32)

項目コレクション内の指定したインデックス位置にある項目のコンテナーを返します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

イベント

SelectionChanged

現在選択されている項目が変更されたときに発生します。 このドキュメントは、UWP 用 WinUI 2 に適用されます (Windows アプリ SDKの WinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

こちらもご覧ください

• ラジオ ボタン