GrapeCity.Win.Containers 名前空間 > GcGroupBoxControlBase クラス : HeaderSettings プロパティ |
Public ReadOnly Property HeaderSettings As GroupHeaderSettings
public GroupHeaderSettings HeaderSettings {get;}
HeaderSettingsは、GroupHeaderSettings.BackColor、GroupHeaderSettings.ForeColor、GroupHeaderSettings.Font、またはGroupHeaderSettings.TextEffectをさまざまに組み合わせてヘッダを項目から区別する場合に使用できます。
また、GcGroupBoxControlBase.HeaderSettings.Alignmentプロパティを設定して、ヘッダの水平方向の配置をカスタマイズできます。GcGroupBoxControlBase.HeaderSettings.AutoEllipsisプロパティをtrueに設定すると、ヘッダのテキストが長すぎる場合にテキストの末尾が省略記号に置き換わります。
次のサンプルコードは、いくつかの項目を含むGcCheckedGroupBoxコントロールを作成する方法を示します。また、HeaderSettingsプロパティを使用してヘッダの外観をカスタマイズする方法も示します。このサンプルコードを実行するには、以下のコードをSystem.Windows.Forms.Formプロジェクトに追加し、ここで作成したメソッドをコンストラクターまたはフォーム上の別のメソッドから呼び出します。
private void CreateMyGcCheckedGroupBoxWithHeaderSettings() { GcCheckedGroupBox gcCheckedGroupBox = new GcCheckedGroupBox(); // Set gcRadioGroupBox1's location. gcCheckedGroupBox.Location = new Point(10, 10); gcCheckedGroupBox.Text = "Center Header"; // 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); // Aligns the header in the center of gcCheckedGroupBox's top border. gcCheckedGroupBox.HeaderSettings.Alignment = HeaderAlignment.Center; // Enables the header's text ellipsis. gcCheckedGroupBox.HeaderSettings.AutoEllipsis = true; // Set the background and foreground of header. gcCheckedGroupBox.HeaderSettings.BackColor = Color.Wheat; gcCheckedGroupBox.HeaderSettings.ForeColor = Color.Tomato; // Set a new font for the header. gcCheckedGroupBox.HeaderSettings.Font = new System.Drawing.Font("Arial", 9.75F, System.Drawing.FontStyle.Bold, System.Drawing.GraphicsUnit.Point, ((byte)(0))); // Enable raised effect for header's text. gcCheckedGroupBox.HeaderSettings.TextEffect = GrapeCity.Win.Common.TextEffect.Raised; // Add gcRadioGroupBo1 to the form. this.Controls.Add(gcCheckedGroupBox); }
Private Sub CreateMyGcCheckedGroupBoxWithHeaderSettings() Dim gcCheckedGroupBox As New GcCheckedGroupBox() ' Set gcRadioGroupBox1's location. gcCheckedGroupBox.Location = New Point(10, 10) gcCheckedGroupBox.Text = "Center Header" ' 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) ' Aligns the header in the center of gcCheckedGroupBox's top border. gcCheckedGroupBox.HeaderSettings.Alignment = HeaderAlignment.Center ' Enables the header's text ellipsis. gcCheckedGroupBox.HeaderSettings.AutoEllipsis = True ' Set the background and foreground of header. gcCheckedGroupBox.HeaderSettings.BackColor = Color.Wheat gcCheckedGroupBox.HeaderSettings.ForeColor = Color.Tomato ' Set a new font for the header. gcCheckedGroupBox.HeaderSettings.Font = New System.Drawing.Font("Arial", 9.75F, System.Drawing.FontStyle.Bold, System.Drawing.GraphicsUnit.Point, CType(0, Byte)) ' Enable raised effect for header's text. gcCheckedGroupBox.HeaderSettings.TextEffect = TextEffect.Raised ' Add gcRadioGroupBo1 to the form. Me.Controls.Add(gcCheckedGroupBox) End Sub
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