GroupItemSettings クラス

グループボックスコントロール内のすべての項目に適用する設定を指定します。

構文

Visual Basic (宣言)
C#

Public Class GroupItemSettings

public class GroupItemSettings

解説

通常は、GcGroupBoxControlBase.ItemSettingsプロパティを通じてGroupItemSettingsにアクセスし、すべての項目のスタイルをカスタマイズします。このプロパティは、すべての項目に統一されたスタイルを適用する簡便な手段を提供します。ただし、グループボックス項目の対応するプロパティが設定されている場合は、その項目のプロパティをnullまたは空の値にリセットしないかぎり、その項目にGcGroupBoxControlBase.ItemSettingsのプロパティ値は適用されません。

使用例

次のサンプルコードは、いくつかの項目を含むGcCheckedGroupBoxコントロールを作成し、ItemSettingsプロパティ上でGroupItemSettingsの一般的なプロパティを設定して項目の外観をカスタマイズする方法を示します。ここでは、グループボックス内のすべての項目でボタンの外観を使用しています。このサンプルコードを実行するには、以下のコードをSystem.Windows.Forms.Formプロジェクトに追加し、ここで作成したメソッドをコンストラクターまたはフォーム上の別のメソッドから呼び出します。

C#
Visual Basic

private void CreateMyGcCheckedGroupBoxWithItemSettings()
{
    GcCheckedGroupBox gcCheckedGroupBox = new GcCheckedGroupBox();

    // Set gcRadioGroupBox1's location.
    gcCheckedGroupBox.Location = new Point(10, 10);
    gcCheckedGroupBox.Text = "Button appearance items";

    // Create some radio button items.
    CheckBoxItem[] items = new CheckBoxItem[] 
    {
        new CheckBoxItem("item1"),
        new CheckBoxItem("item2"),
        new CheckBoxItem("item3"),
    };

    // First add some items.
    gcCheckedGroupBox.Items.AddRange(items);

    // Use flat theme to draw gcCheckedGroupBox.
    gcCheckedGroupBox.FlatStyle = GrapeCity.Win.Common.FlatStyleEx.Flat;

    // Set all items as button appearance.
    gcCheckedGroupBox.ItemSettings.Appearance = Appearance.Button;

    gcCheckedGroupBox.ItemSettings.UseVisualStyleBackColor = false;

    // Set all items' background and foreground color.
    gcCheckedGroupBox.ItemSettings.BackColor = Color.AliceBlue;
    gcCheckedGroupBox.ItemSettings.ForeColor = Color.Blue;

    // Set all items' font.
    gcCheckedGroupBox.ItemSettings.Font = new System.Drawing.Font("Arial", 8.25F, System.Drawing.FontStyle.Regular, System.Drawing.GraphicsUnit.Point, ((byte)(0)));
    
    // Set all items' TextEffect.
    gcCheckedGroupBox.ItemSettings.TextEffect = GrapeCity.Win.Common.TextEffect.Raised;

    // Customize the flat appearance.
    gcCheckedGroupBox.ItemSettings.FlatAppearance.BorderColor = Color.Violet;
    gcCheckedGroupBox.ItemSettings.FlatAppearance.BorderSize = 2;
    gcCheckedGroupBox.ItemSettings.FlatAppearance.CheckedBackColor = Color.Red;
    gcCheckedGroupBox.ItemSettings.FlatAppearance.MouseDownBackColor = Color.RosyBrown;
    gcCheckedGroupBox.ItemSettings.FlatAppearance.MouseOverBackColor = Color.Silver;

    // Customize the layout of items.
    gcCheckedGroupBox.LayoutSettings.LayoutMode = LayoutMode.Flow;
    gcCheckedGroupBox.LayoutSettings.HorizontalSpace = 5;

    // Add gcRadioGroupBox to the form.
    this.Controls.Add(gcCheckedGroupBox);
}

Private Sub CreateMyGcCheckedGroupBoxWithItemSettings()
    Dim gcCheckedGroupBox As New GcCheckedGroupBox()

    ' Set gcRadioGroupBox1's location.
    gcCheckedGroupBox.Location = New Point(10, 10)
    gcCheckedGroupBox.Text = "Button appearance items"

    ' Create some radio button items.
    Dim items As CheckBoxItem() = New CheckBoxItem() {New CheckBoxItem("item1"), New CheckBoxItem("item2"), New CheckBoxItem("item3")}

    ' First add some items.
    gcCheckedGroupBox.Items.AddRange(items)

    ' Use flat theme to draw gcCheckedGroupBox.
    gcCheckedGroupBox.FlatStyle = FlatStyleEx.Flat

    ' Set all items as button appearance.
    gcCheckedGroupBox.ItemSettings.Appearance = Appearance.Button

    gcCheckedGroupBox.ItemSettings.UseVisualStyleBackColor = False

    ' Set all items' background and foreground color.
    gcCheckedGroupBox.ItemSettings.BackColor = Color.AliceBlue
    gcCheckedGroupBox.ItemSettings.ForeColor = Color.Blue

    ' Set all items' font.
    gcCheckedGroupBox.ItemSettings.Font = New System.Drawing.Font("Arial", 8.25F, System.Drawing.FontStyle.Regular, System.Drawing.GraphicsUnit.Point, CType(0, Byte))

    ' Set all items' TextEffect.
    gcCheckedGroupBox.ItemSettings.TextEffect = TextEffect.Raised

    ' Customize the flat appearance.
    gcCheckedGroupBox.ItemSettings.FlatAppearance.BorderColor = Color.Violet
    gcCheckedGroupBox.ItemSettings.FlatAppearance.BorderSize = 2
    gcCheckedGroupBox.ItemSettings.FlatAppearance.CheckedBackColor = Color.Red
    gcCheckedGroupBox.ItemSettings.FlatAppearance.MouseDownBackColor = Color.RosyBrown
    gcCheckedGroupBox.ItemSettings.FlatAppearance.MouseOverBackColor = Color.Silver

    ' Customize the layout of items.
    gcCheckedGroupBox.LayoutSettings.LayoutMode = LayoutMode.Flow
    gcCheckedGroupBox.LayoutSettings.HorizontalSpace = 5

    ' Add gcRadioGroupBox to the form.
    Me.Controls.Add(gcCheckedGroupBox)
End Sub

継承階層

System.Object
GrapeCity.Win.Containers.GroupItemSettings

プラットフォーム

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

参照

GroupItemSettings メンバ
 GrapeCity.Win.Containers 名前空間
 ItemSettings プロパティ
 ItemSettings プロパティ