syncfusion-winforms-radio-button

Syncfusion WinForms での RadioButtonAdv の実装

このスキルでは、Syncfusion WinForms RadioButtonAdv コントロールの実装方法を説明します。Office テーマ、グラデーション背景、テキストの影効果、カスタム画像、プロフェッショナルな外観など、高度なスタイル設定を備えた拡張版ラジオボタンです。

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

次のような場合に、このスキルを使用します。

• 標準の RadioButton を超える、モダンなスタイルの拡張ラジオボタンを実装する
• Office テーマ（Office2007、Office2016 Colorful／White／Black／DarkGray）を適用する
• モダンな UI デザインにMetro スタイルのラジオボタンを使用する
• カスタムの色やオフセットを指定してテキストの影効果を追加する
• ラジオボタンにグラデーション背景を設定する
• ラジオボタンの状態に応じてカスタム画像を表示する
• ラジオボタンに2D または 3D の境界線スタイルを適用する
• カスタムレイアウトに合わせてテキストとボタンの配置を設定する
• ラジオボタンの状態に整数値または文字列値を関連付ける
• Office スタイルのテーマを統一したプロフェッショナルなフォームを作成する
• 見た目を強化した代替コントロールで標準の RadioButtonを置き換える

RadioButtonAdv は、ラジオボタンコントロールの外観とテーマ設定が重要な場合に最適です。

コンポーネントの概要

RadioButtonAdv は、豊富なスタイル設定機能を備え、標準の WinForms RadioButton を拡張した高度なラジオボタンコントロールです。次の機能を提供します。

• テーマのサポート：Office2007、Office2016、Metro、Default の各テーマ
• テキスト効果：色やオフセットをカスタマイズできる影付きテキスト
• 背景：色をカスタマイズできるグラデーション背景
• 境界線：2D および 3D の境界線スタイルのオプション
• 画像：各チェック状態に対応するカスタム画像
• 配置：柔軟なテキストとボタンの配置
• 値の関連付け：状態ごとの整数値／文字列値
• 動作オプション：高さの自動調整、フォーカス四角形、クリックイベント

標準の RadioButton との主な違い： RadioButtonAdv は、標準的なラジオボタンの機能を維持しながら、外観のスタイル設定とテーマ設定の機能を追加します。

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

はじめにと基本設定

📄 参照： references/getting-started.md

次の情報が必要な場合は、このリファレンスを参照してください。

• アセンブリの依存関係と NuGet パッケージのインストール
• デザイナーまたはコードで RadioButtonAdv を作成する方法
• 基本プロパティ（Text、Font、ForeColor、BackColor）
• RadioButtonAdv をフォームに追加する方法
• コントロール階層の理解
• 最小限の実行可能なサンプル一式

テーマとビジュアルスタイル

📄 参照： references/themes-and-styles.md

次の情報が必要な場合は、このリファレンスを参照してください。

• ThemesEnabled プロパティを使用したテーマの有効化
• Style プロパティの適用（Default、Office2007、Metro、Office2016 の各バリアント）
• Office2007ColorScheme（Managed、Blue、Silver、Black）
• Office2007 テーマのカスタム管理色
• テーマを適用したサンプル一式
• プロフェッショナルな Office スタイルの外観

テキスト設定と効果

📄 参照： references/text-settings.md

次の情報が必要な場合は、このリファレンスを参照してください。

• 影効果を設定する TextShadow プロパティ
• ShadowColor のカスタマイズ
• ShadowOffset の位置調整
• 長いテキストに対応する WrapText
• テキスト効果のサンプル
• テキストのスタイル設定に関するベストプラクティス

外観のカスタマイズ

📄 参照： references/appearance-customization.md

次の情報が必要な場合は、このリファレンスを参照してください。

• カスタム色を使ったグラデーション背景
• 境界線スタイル（2D および 3D のオプション）
• テキストとボタンの配置設定
• 状態ごとのカスタム画像
• 外観を完全にカスタマイズする方法
• 高度なスタイル設定のパターン

動作設定

📄 参照： references/behavior-settings.md

次の情報が必要な場合は、このリファレンスを参照してください。

• 高さを自動計算する AutoHeight
• DrawFocusRectangle の表示制御
• RaiseEventOnClick のイベント動作
• RadioButtonAdv の Settings（整数値／文字列値の関連付け）
• 動作の設定オプション

イベント

📄 参照: references/events.md

次の情報が必要な場合は、このリファレンスを参照してください：

• 利用可能な RadioButtonAdv イベント
• Click イベントの処理
• CheckedChanged イベント
• イベントに関するベストプラクティス
• 一般的なイベントパターン

クイックスタートの例

テーマを適用した RadioButtonAdv コントロールを作成する最小限の例です：

using Syncfusion.Windows.Forms.Tools;
using System;
using System.Drawing;
using System.Windows.Forms;

public class RadioButtonExample : Form
{
    private RadioButtonAdv radioButtonAdv1;
    private RadioButtonAdv radioButtonAdv2;
    private RadioButtonAdv radioButtonAdv3;
    
    public RadioButtonExample()
    {
        // Create first radio button
        radioButtonAdv1 = new RadioButtonAdv();
        radioButtonAdv1.Text = "Option 1";
        radioButtonAdv1.Location = new Point(20, 20);
        radioButtonAdv1.Size = new Size(120, 21);
        radioButtonAdv1.Style = RadioButtonAdvStyle.Office2016Colorful;
        radioButtonAdv1.Checked = true;
        
        // Create second radio button
        radioButtonAdv2 = new RadioButtonAdv();
        radioButtonAdv2.Text = "Option 2";
        radioButtonAdv2.Location = new Point(20, 50);
        radioButtonAdv2.Size = new Size(120, 21);
        radioButtonAdv2.Style = RadioButtonAdvStyle.Office2016Colorful;
        
        // Create third radio button
        radioButtonAdv3 = new RadioButtonAdv();
        radioButtonAdv3.Text = "Option 3";
        radioButtonAdv3.Location = new Point(20, 80);
        radioButtonAdv3.Size = new Size(120, 21);
        radioButtonAdv3.Style = RadioButtonAdvStyle.Office2016Colorful;
        
        // Add to form
        this.Controls.Add(radioButtonAdv1);
        this.Controls.Add(radioButtonAdv2);
        this.Controls.Add(radioButtonAdv3);
        
        this.Text = "RadioButtonAdv Example";
        this.Size = new Size(300, 200);
    }
}

結果： モダンな外観の Office2016 テーマのラジオボタンが 3 つ表示されます。

一般的なパターン

テーマを適用したラジオボタングループ

パターン： Office2016 テーマを統一して適用したラジオボタンのグループを作成します。

// Create GroupBox for radio buttons
GroupBox groupBox = new GroupBox();
groupBox.Text = "Select Option";
groupBox.Location = new Point(10, 10);
groupBox.Size = new Size(200, 120);

// Create themed radio buttons
string[] options = { "Small", "Medium", "Large" };
int yPos = 20;

foreach (string option in options)
{
    RadioButtonAdv radio = new RadioButtonAdv();
    radio.Text = option;
    radio.Location = new Point(10, yPos);
    radio.Style = RadioButtonAdvStyle.Office2016Colorful;
    radio.ThemesEnabled = true;
    groupBox.Controls.Add(radio);
    yPos += 30;
}

this.Controls.Add(groupBox);

使用する場面： 関連する複数の選択肢に統一したテーマを適用する場合に使用します。

テキストシャドウ付きラジオボタン

パターン： テキストシャドウ効果を加えて、視覚的な強調を行います。

RadioButtonAdv shadowRadio = new RadioButtonAdv();
shadowRadio.Text = "Important Option";
shadowRadio.TextShadow = true;
shadowRadio.ShadowColor = Color.Gold;
shadowRadio.ShadowOffset = new Point(2, 2);
shadowRadio.Font = new Font("Segoe UI", 10, FontStyle.Bold);
shadowRadio.Location = new Point(20, 20);

使用する場面： 特定のラジオボタンの選択肢を強調したい場合に使用します。

カスタムのグラデーション背景

パターン： モダンな外観のグラデーション背景を持つラジオボタンを作成します。

RadioButtonAdv gradientRadio = new RadioButtonAdv();
gradientRadio.Text = "Premium Option";
// Gradient properties set via designer or property grid
// GradientStart, GradientEnd, GradientStyle
gradientRadio.Location = new Point(20, 20);

使用する場面： ブランドに合わせたカスタムスタイルのラジオボタンが必要な場合に使用します。

主なプロパティ

テーマとスタイルのプロパティ

Property	Type	Description	When to Use
Style	RadioButtonAdvStyle	Office2007、Metro、Office2016 の各バリエーション	モダンなテーマを適用する
ThemesEnabled	bool	テーマの有効化／無効化	テーマの適用を制御する
Office2007ColorScheme	Office2007Theme	Blue、Silver、Black、Managed	Office2007 の色のバリエーションを指定する

テキストのプロパティ

Property	Type	Description	When to Use
TextShadow	bool	テキストシャドウ効果を有効にする	テキストに視覚的な奥行きを加える
ShadowColor	Color	シャドウの色	シャドウの外観をカスタマイズする
ShadowOffset	Point	シャドウ位置のオフセット	シャドウの配置を制御する
WrapText	bool	テキストの折り返しを有効にする	長いテキストラベルに対応する

外観のプロパティ

Property	Type	Description	When to Use
DrawFocusRectangle	bool	フォーカス枠の表示／非表示	フォーカスインジケーターを制御する
AutoHeight	bool	高さを自動計算する	コンテンツのサイズに合わせる
BackColor	Color	背景色	カスタム背景を設定する
ForeColor	Color	テキストの色	テキストの色をカスタマイズする

動作のプロパティ

Property	Type	Description	When to Use
RaiseEventOnClick	bool	OnClick イベントを発生させる	クリック時の動作を制御する
Checked	bool	ラジオボタンの状態	デフォルトの選択項目を設定する

一般的な使用例

設定ダイアログ

テーマを適用したラジオボタンで設定フォームを作成します：

• 関連する選択肢（テーマ、サイズ、レイアウト）をグループ化する
• Office2016 テーマを統一して適用する
• アプリケーションのスタイルに合ったプロフェッショナルな外観にする

ウィザードのステップ選択

ウィザードのナビゲーションにラジオボタンを使用します：

• モダンな外観にするため、Metro または Office2016 スタイルを使用する
• 現在のステップを強調するため、テキストシャドウを使用する
• 明確な視覚的階層を設ける

アンケート／質問票フォーム

スタイルを設定したラジオボタンで複数選択式の質問を作成します：

• すべての質問に統一したテーマを適用する
• 長い選択肢のラベルにテキストの折り返しを適用する
• プロフェッショナルなアンケートの外観にする

環境設定

ユーザー設定を選択します：

• プレミアムな選択肢にグラデーション背景を使用する
• 視覚的なインジケーターとして、状態ごとにカスタム画像を使用する
• 環境設定を簡単に保存できるよう、値を関連付ける

実装チェックリスト

RadioButtonAdv を実装する際は、次の点を確認してください：

• ✅ 必要なアセンブリを参照している（Syncfusion.Tools.Windows.dll など）
• ✅ 名前空間を含めている（Syncfusion.Windows.Forms.Tools）
• ✅ RadioButtonAdv のインスタンスを作成し、設定している
• ✅ 外観を統一するためにスタイル／テーマを適用している
• ✅ テキストのプロパティを設定している（Text、Font、任意のシャドウ）
• ✅ レイアウト用に位置とサイズを指定している
• ✅ CheckedChanged または Click 用のイベントハンドラーを追加している
• ✅ ラジオボタングループを適切に設定している（グループごとに選択できるのは 1 つだけ）
• ✅ Checked プロパティでデフォルトの選択項目を設定している
• ✅ さまざまなテーマやスタイルでテストしている

トラブルシューティングのクイックリファレンス

問題： テーマが適用されない

• ThemesEnabled = true に設定します
• Style プロパティが目的のテーマに設定されていることを確認します
• カスタムの BackColor がテーマを上書きしていないか確認します

問題： テキストの影が表示されない

• TextShadow = true に設定します
• コントラストのある ShadowColor を選択します
• 影が見えるように ShadowOffset を調整します

問題： ラジオボタンが相互に排他的にならない

• ラジオボタンが同じコンテナー（Form、Panel、GroupBox）内にあることを確認します
• 同じ親コンテナー内のラジオボタンのみがグループ化されます

問題： フォーカス矩形が常に表示される

• 非表示にするには DrawFocusRectangle = false に設定します
• フォームレベルの設定がコントロールを上書きしていないか確認します

問題： テキストに合わせて高さが調整されない

• AutoHeight = true に設定します
• テキストが長い場合は WrapText が設定されていることを確認します

まとめ

RadioButtonAdv は、次のような拡張されたラジオボタン機能を提供します。

• プロフェッショナルなテーマ：Office2007、Office2016、Metro スタイル
• テキスト効果：カスタムカラーとオフセットによる影
• 視覚的なカスタマイズ：グラデーション、境界線、画像
• 柔軟なスタイル設定：配置、外観、動作の各オプション

プロフェッショナルでモダンな WinForms アプリケーションを作成するうえで、視覚的な外観とテーマ設定が重要な場合は RadioButtonAdv を使用してください。