RadioButtons クラス

定義

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

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

/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
/// [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.Foundation.Metadata.Version(1)]
/// [Windows.UI.Xaml.Markup.ContentProperty(Name="Items")]
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(Microsoft.UI.Xaml.XamlContract, 65536)]
class RadioButtons : Control
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=0)]
[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.Foundation.Metadata.Version(1)]
[Windows.UI.Xaml.Markup.ContentProperty(Name="Items")]
public 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
継承
RadioButtons
属性
Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute ContentPropertyAttribute ContractVersionAttribute

ヒント

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

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

注釈

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

1 つのラジオ ボタンが選択されている RadioButtons グループの例

オプション ボタンとも呼ばれるラジオ ボタンを使用して、ユーザーが 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 アプリ SDKWinUI の場合は、Windows アプリ SDK名前空間を参照してください)。

プロパティ

Header

グループ ヘッダーの内容を取得または設定します。

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

HeaderProperty

Header 依存関係プロパティを識別します。

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

HeaderTemplate

コントロールのヘッダーの内容を表示するために使用するデータ テンプレートを取得または設定します。

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

HeaderTemplateProperty

HeaderTemplate 依存関係プロパティを識別します。

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

Items

コントロールの内容を生成するために使用されるコレクションを取得します。

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

ItemsProperty

Items 依存関係プロパティを識別 します

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

ItemsSource

コントロールのコンテンツの生成に使用するオブジェクト ソースを取得または設定します。

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

ItemsSourceProperty

ItemsSource 依存関係プロパティを識別します。

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

ItemTemplate

各項目の表示に使用する DataTemplate を取得または設定します。

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

ItemTemplateProperty

ItemTemplate 依存関係プロパティを識別します。

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

MaxColumns

ラジオ ボタンを配置する列の最大数を取得または設定します。

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

MaxColumnsProperty

MaxColumns 依存関係プロパティを識別します。

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

SelectedIndex

選択したラジオ ボタンのインデックスを取得または設定します。

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

SelectedIndexProperty

SelectedIndex 依存関係プロパティを識別します。

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

SelectedItem

選択したラジオ ボタンを取得または設定します。

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

SelectedItemProperty

SelectedItem 依存関係プロパティを識別します。

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

メソッド

ContainerFromIndex(Int32)

項目コレクション内の指定したインデックス位置にある項目のコンテナーを返します。

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

イベント

SelectionChanged

現在選択されている項目が変更されたときに発生します。

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

適用対象

こちらもご覧ください