RadioButtonItem クラス

GcRadioGroupBoxコントロールに含まれる項目を表します。

構文

Visual Basic (宣言)
C#

Public Class RadioButtonItem

public class RadioButtonItem

解説

RadioButtonItemはSystem.Windows.Forms.RadioButtonコントロールと同じように動作しますが、System.Windows.Forms.Controlではありません。これは単に、GcRadioGroupBoxコントロールに表示される項目に関連付けられた外観、動作、およびデータを定義するだけです。RadioButtonItemを表示するためには、その項目をGcRadioGroupBox.Itemsに追加する必要があります。RadioButtonItemには、複数のGcRadioGroupBoxコントロールに追加できないという制約があります。そのため、すでに別のGcRadioGroupBoxが所有している項目を再利用する場合には、その項目のクローンを作成してから、その項目のコピーを他のGcRadioGroupBoxコントロールに追加する必要があります。

RadioButtonItemクラスは、関連付けられたGcRadioGroupBoxコントロールに含まれる項目の外観を変更する手段を提供します。BackColor、ForeColor、Fontの各プロパティを使用して、GcRadioGroupBoxコントロールでの項目テキストの表示方法を変更できます。Enabledプロパティは、項目がユーザー操作に応答するかどうかを決定します。Checkedプロパティは、RadioButtonItemのチェック状態を示します。Locationは、関連付けられたGcRadioGroupBoxコントロールがLayoutMode.Absoluteモードである場合にのみ有効です。

RadioButtonItemクラスには、既存のRadioButtonItemオブジェクトのコピーを作成して他のGcRadioGroupBoxコントロールで再利用できるようにするCloneメソッドも用意されています。

使用例

次のサンプルコードは、RadioButtonItemオブジェクトを2つ作成してGcRadioGroupBoxコントロールに追加し、項目の一般的なプロパティを設定します。この例を実行するには、以下のコードをSystem.Windows.Forms.Formに追加し、ここで作成したメソッドをフォームのコンストラクターまたはSystem.Windows.Forms.Form.Loadイベントハンドラから呼び出す必要があります。

C#
Visual Basic

public void CreateMyGcRadioGroupBox()
{
    GcRadioGroupBox gcRadioGroupBox1 = new GcRadioGroupBox();
    gcRadioGroupBox1.Location = new Point(15, 15);
    gcRadioGroupBox1.Text = "MyGcRadioGroupBox";

    // Create an item.
    RadioButtonItem item = new RadioButtonItem();

    // Set the Text of RadioButtonItem.
    item.Text = "MyRadioButtonItem";

    // Set a new Font from the existing font.
    item.Font = new Font(item.Font, FontStyle.Bold);

    // Set the BackColor and ForeColor properties for RadioButtonItem.
    item.BackColor = Color.LightGreen;
    item.ForeColor = Color.LightPink;

    // Disable the item.
    item.Enabled = false;

    gcRadioGroupBox1.LayoutSettings.LayoutMode = LayoutMode.Absolute;
    // Set the location of the item.
    item.Location = new Point(15, 15);

    // Clone an item, modify its location and change its Enabled to true to enable the UI interaction.
    RadioButtonItem clonedItem = item.Clone() as RadioButtonItem;
    clonedItem.Location = new Point(15, 40);
    clonedItem.Enabled = true;

    gcRadioGroupBox1.Items.Add(item);
    gcRadioGroupBox1.Items.Add(clonedItem);
    this.Controls.Add(gcRadioGroupBox1);
}

Public Sub CreateMyGcRadioGroupBox()
    Dim gcRadioGroupBox1 As New GcRadioGroupBox()
    gcRadioGroupBox1.Location = New Point(15, 15)
    gcRadioGroupBox1.Text = "MyGcRadioGroupBox"

    ' Create an item.
    Dim item As New RadioButtonItem()

    ' Set the Text of RadioButtonItem.
    item.Text = "MyRadioButtonItem"

    ' Set a new Font from the existing font.
    item.Font = New Font(item.Font, FontStyle.Bold)

    ' Set the BackColor and ForeColor properties for RadioButtonItem.
    item.BackColor = Color.LightGreen
    item.ForeColor = Color.LightPink

    ' Disable the item.
    item.Enabled = False

    gcRadioGroupBox1.LayoutSettings.LayoutMode = LayoutMode.Absolute
    ' Set the location of the item.
    item.Location = New Point(15, 15)

    ' Clone an item, modify its location and change its Enabled to true to enable the UI interaction.
    Dim clonedItem As RadioButtonItem = TryCast(item.Clone(), RadioButtonItem)
    clonedItem.Location = New Point(15, 40)
    clonedItem.Enabled = True

    gcRadioGroupBox1.Items.Add(item)
    gcRadioGroupBox1.Items.Add(clonedItem)
    Me.Controls.Add(gcRadioGroupBox1)
End Sub

継承階層

System.Object
GrapeCity.Win.Containers.RadioButtonItem

プラットフォーム

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

参照

RadioButtonItem メンバ
 GrapeCity.Win.Containers 名前空間
 GcRadioGroupBox クラス
 RadioButtonItemCollection クラス
 GcRadioGroupBox クラス
 RadioButtonItemCollection クラス