PowerTools PlusPak for Windows Forms 8.0J
CheckBoxItem クラス
メンバ  使用例 

GcCheckedGroupBoxコントロールに含まれる項目を表します。
構文
Public Class CheckBoxItem 
public class CheckBoxItem 
解説

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

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

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

使用例
次のサンプルコードは、CheckBoxItemオブジェクトを2つ作成してGcCheckedGroupBoxコントロールに追加し、項目の一般的なプロパティを設定します。この例を実行するには、以下のコードをSystem.Windows.Forms.Formに追加し、ここで作成したメソッドをフォームのコンストラクターまたはSystem.Windows.Forms.Form.Loadイベントハンドラから呼び出す必要があります。
public void CreateMyGcCheckedGroupBox()
{
    GcCheckedGroupBox gcCheckedGroupBox1 = new GcCheckedGroupBox();
    gcCheckedGroupBox1.Location = new Point(15, 15);
    gcCheckedGroupBox1.Text = "MyGcCheckedGroupBox";

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

    // Set the Text of CheckBoxItem.
    item.Text = "MyCheckBoxItem";

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

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

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

    gcCheckedGroupBox1.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.
    CheckBoxItem clonedItem = item.Clone() as CheckBoxItem;
    clonedItem.Location = new Point(15, 40);
    clonedItem.Enabled = true;

    gcCheckedGroupBox1.Items.Add(item);
    gcCheckedGroupBox1.Items.Add(clonedItem);
    this.Controls.Add(gcCheckedGroupBox1);
}
Public Sub CreateMyGcCheckedGroupBox()
    Dim gcCheckedGroupBox1 As New GcCheckedGroupBox()
    gcCheckedGroupBox1.Location = New Point(15, 15)
    gcCheckedGroupBox1.Text = "MyGcCheckedGroupBox"

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

    ' Set the Text of CheckBoxItem.
    item.Text = "MyCheckBoxItem"

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

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

    ' Disable the item.
    item.Enabled = False

    gcCheckedGroupBox1.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 CheckBoxItem = TryCast(item.Clone(), CheckBoxItem)
    clonedItem.Location = New Point(15, 40)
    clonedItem.Enabled = True

    gcCheckedGroupBox1.Items.Add(item)
    gcCheckedGroupBox1.Items.Add(clonedItem)
    Me.Controls.Add(gcCheckedGroupBox1)
End Sub
継承階層

System.Object
   GrapeCity.Win.Containers.CheckBoxItem

プラットフォーム

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

参照

CheckBoxItem メンバ
GrapeCity.Win.Containers 名前空間
GcCheckedGroupBox クラス
CheckBoxItemCollection クラス
CheckedCheckBoxItemCollection クラス
CheckedCheckBoxIndexCollection クラス
GcCheckedGroupBox クラス
CheckBoxItemCollection クラス
CheckedCheckBoxItemCollection クラス
CheckedCheckBoxIndexCollection クラス

Send Feedback