syncfusion-maui-radio-button

.NET MAUI ラジオボタンの実装

Syncfusion .NET MAUI ラジオボタン（SfRadioButton）の実装ガイドです。チェック状態と未チェック状態を持ち、ユーザーが複数の選択肢から 1 つを選択できる選択コントロールです。

このスキルを使用する場面

次のような場合に、このスキルを使用してください。

• .NET MAUI で、相互に排他的な選択肢のラジオボタンを実装する
• 1 つの選択肢のみを選べるラジオボタンのグループを作成する
• ラジオボタンの状態変化とユーザー操作を処理する
• ラジオボタンの外観（色、サイズ、テキストのスタイル）をカスタマイズする
• GroupKey または SfRadioGroup に基づくグループ化を実装する
• ラジオボタンのイベント（StateChanged、StateChanging）を扱う
• ラジオボタンに VisualStateManager を適用する
• 単一選択式の選択肢（支払い方法、設定など）を含むフォームを作成する

コンポーネントの概要

Syncfusion .NET MAUI ラジオボタン（SfRadioButton）には、次の機能があります。

• 2 つの状態： 視覚的なフィードバックを伴うチェック状態と未チェック状態
• グループ化： 相互排他制御のための複数の方法（SfRadioGroup、GroupKey）
• イベント： 操作処理のための StateChanged と StateChanging
• カスタマイズ： 色、テキスト、サイズの豊富なスタイル設定オプション
• ビジュアル状態： 高度なスタイル設定のための VisualStateManager との統合

ドキュメントとナビゲーションガイド

はじめに

📄 参照： references/getting-started.md

• Syncfusion.Maui.Buttons NuGet パッケージのインストール
• MauiProgram.cs での Syncfusion ハンドラーの登録
• 最初の SfRadioButton の作成（XAML と C#）
• Text プロパティを使用したキャプションテキストの設定
• IsChecked によるラジオボタンの状態管理
• 相互排他制御の基本的な SfRadioGroup の使用方法
• すぐに使い始められる最小限の動作例

グループ化と構成

📄 参照： references/grouping.md

• GroupKey を使う方法：異なるレイアウトにあるラジオボタンをグループ化する
• CheckedItem プロパティ：現在選択されているラジオボタンを取得する
• SfRadioGroup コンテナー：相互排他制御を自動的に管理する
• CheckedChanged イベント：グループ内の選択変更に応答する
• 配置オプション：垂直（既定）または水平のレイアウト
• SelectedValue プロパティ：選択されたラジオボタンの値にバインドする
• GroupKey と SfRadioGroup のどちらを使用するか選択する
• 同じビュー内で複数の独立したグループを作成する
• 高度なグループ化のシナリオとパターン

イベントと操作

📄 参照： references/events.md

• StateChanged イベント：ラジオボタンの状態変化を検出する
• StateChangedEventArgs：新しい状態の情報にアクセスする
• StateChanging イベント：状態変化を捕捉してキャンセルする
• イベントハンドラーの実装パターン（XAML と C#）
• イベントのキャンセルによる意図しない状態変化の防止
• イベントのタイミングとライフサイクルに関する考慮事項
• 実用的なシナリオ：検証、確認ダイアログ
• ユーザー操作にプログラムから応答する

外観のカスタマイズ

📄 参照： references/visual-customization.md

• CheckedColor と UncheckedColor：状態ごとの色をカスタマイズする
• StrokeThickness：ラジオボタンの枠線を調整する（プラットフォームごとの考慮事項）
• テキストの外観：TextColor、FontFamily、FontAttributes、FontSize
• HorizontalTextAlignment：テキストの配置を制御する
• LineBreakMode：テキストの折り返しと省略表示のオプション
• ControlSize：ラジオボタンの寸法を調整する
• ContentSpacing：ボタンとテキストの間隔を制御する
• FontAutoScalingEnabled：アクセシビリティ向上のためにフォントを自動拡大する
• EnabledAnimation：状態変化のアニメーションを制御する
• スタイル設定の完全な例とベストプラクティス

ビジュアル状態

📄 参照： references/visual-states.md

• SfRadioButton と VisualStateManager の統合
• 使用可能なビジュアル状態：Checked と Unchecked
• XAML でのビジュアル状態の定義
• C# でプログラムからビジュアル状態を作成する
• 各状態の外観をカスタマイズする
• 状態ごとに複数のプロパティセッターを適用する
• 完全な動作例
• ビジュアル状態管理のベストプラクティス