RadioButton クラス

Windows のオプション ボタンを表します。

この型のすべてのメンバの一覧については、RadioButton メンバ を参照してください。

System.Object
   System.MarshalByRefObject
      System.ComponentModel.Component
         System.Windows.Forms.Control
            System.Windows.Forms.ButtonBase
               System.Windows.Forms.RadioButton

Public Class RadioButton
   Inherits ButtonBase
[C#]
public class RadioButton : ButtonBase
[C++]
public __gc class RadioButton : public ButtonBase
[JScript]
public class RadioButton extends ButtonBase

スレッドセーフ

この型の public static (Visual Basicでは Shared) のすべてのメンバは、マルチスレッド操作で安全に使用できます。インスタンスのメンバの場合は、スレッドセーフであるとは限りません。

解説

RadioButton コントロールには、テキストおよび Image 、またはその両方を表示できます。

ユーザーがグループ内のオプション ボタンの 1 つを選択すると、ほかのボタンは自動的にオフになります。特定のコンテナ内にある Form などのすべての RadioButton コントロールは、1 つのグループとなります。1 つのフォーム上に複数のグループを作成する場合は、グループを GroupBox コントロールや Panel コントロールなどの独自のコンテナに配置します。

RadioButton コントロールと CheckBox コントロールには似た機能があり、ユーザーが選択または選択解除できる選択肢を表示します。相違点は、 CheckBox コントロールが同時に複数選択できるのに対して、オプション ボタンは一度に 1 つしか選択できない点です。

Checked プロパティを使用して、 RadioButton の状態を取得または設定します。オプション ボタンの外観は、 Appearance プロパティを設定して変更でき、トグル スタイルのボタンまたは標準のオプション ボタンで表示できます。

メモ   オプション ボタンは、ラジオ ボタンと呼ばれることもあります。

使用例

[Visual Basic, C#, C++] RadioButton を作成および初期化し、トグル ボタンのような外観にする例を次に示します。そのトグル ボタンの AutoCheck プロパティを false に設定し、トグル ボタンを Form に追加します。

 
Private Sub InitializeMyRadioButton()
    ' Create and initialize a new RadioButton. 
    Dim radioButton1 As New RadioButton()
       
    ' Make the radio button control appear as a toggle button.
    radioButton1.Appearance = Appearance.Button
       
    ' Turn off the update of the display on the click of the control.
    radioButton1.AutoCheck = False
       
    ' Add the radio button to the form.
    Controls.Add(radioButton1)
End Sub


[C#] 
private void InitializeMyRadioButton()
{
   // Create and initialize a new RadioButton. 
   RadioButton radioButton1 = new RadioButton();
   
   // Make the radio button control appear as a toggle button.
   radioButton1.Appearance = Appearance.Button;

   // Turn off the update of the display on the click of the control.
   radioButton1.AutoCheck = false;

   // Add the radio button to the form.
   Controls.Add(radioButton1);
}


[C++] 
private:
    void InitializeMyRadioButton() {
        // Create and initialize a new RadioButton. 
        RadioButton __gc *radioButton1 = new RadioButton();

        // Make the radio button control appear as a toggle button.
        radioButton1->Appearance = Appearance::Button;

        // Turn off the update of the display on the click of the control.
        radioButton1->AutoCheck = false;

        // Add the radio button to the form.
        Controls->Add(radioButton1);
    };

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

名前空間: System.Windows.Forms

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

アセンブリ: System.Windows.Forms (System.Windows.Forms.dll 内)

参照

RadioButton メンバ | System.Windows.Forms 名前空間 | ButtonBase | Button | CheckBox