子コントロールにキャプションを追加

タブページ上に配置したコントロールに対し、キャプションを追加することができます。

キャプションの文字は GcTabPage.SetCaptionText メソッドで設定します。また、キャプションのスタイルは、タブページ上の全てのコントロールに同じスタイルを適用する方法と、タブページ上の個々のコントロールにそれぞれ異なるスタイルを適用する方法があります。キャプションのスタイルの適用方法は GcTabPage.ApplyCaptionFormat プロパティにより行います。

全てのコントロールに同一のスタイルを適用する場合

タブページ上の全てのコントロールに同じスタイルを適用する場合は、GcTabPage.ApplyCaptionFormat プロパティを All に設定します。また、スタイルの各設定は GcTabPage.CaptionFormat プロパティが参照する CaptionFormat クラスにより行います。

キャプションは、次のような項目が設定できます。

プロパティ	説明
BackColor	キャプションの背景色
Font	フォント
ForeColor	キャプションの文字色
Orientation	コントロールに対するキャプションの位置 ( 左、上）
Size	キャプションの表示領域のサイズ
Spacing	キャプションとコントロールの間隔
TextEffect	文字の 3D 効果 ( フラット、強いくぼみ、強い浮き出し、くぼみ、浮き出し )
TextHAlign	文字の水平方向の配置
TextVAlign	文字の垂直方向の配置 ( タブと同様に均等割付も可能 )
WrapMode	ワードラップ

以下はコードで設定する場合の例です。

Visual Basic
C#

' 全ての子コントロールにキャプションのスタイルを適用します
GcTabPage1.ApplyCaptionFormat = GrapeCity.Win.Containers.ApplyToChild.All
' キャプションのスタイルを設定します
Dim MyFormat As GrapeCity.Win.Containers.CaptionFormat = New GrapeCity.Win.Containers.CaptionFormat
MyFormat.BackColor = Color.PeachPuff
MyFormat.Font = New Font("MS UI Gothic", 10, FontStyle.Bold)
MyFormat.ForeColor = Color.DarkGreen
MyFormat.Orientation = GrapeCity.Win.Containers.CaptionOrientation.Left
MyFormat.Size = 80
MyFormat.Spacing = 10
MyFormat.TextEffect = GrapeCity.Win.Common.TextEffect.Raised
MyFormat.TextHAlign = GrapeCity.Win.Common.TextHAlign.Justify
MyFormat.TextVAlign = GrapeCity.Win.Common.TextVAlign.Middle
MyFormat.WrapMode = GrapeCity.Win.Common.TextWrapMode.WordWrap
GcTabPage1.CaptionFormat = MyFormat
' キャプションの文字を設定します
GcTabPage1.SetCaptionText(TextBox1, "キャプション")

// 全ての子コントロールにキャプションのスタイルを適用します
gcTabPage1.ApplyCaptionFormat = GrapeCity.Win.Containers.ApplyToChild.All;
// キャプションのスタイルを設定します
GrapeCity.Win.Containers.CaptionFormat MyFormat = new GrapeCity.Win.Containers.CaptionFormat();
MyFormat.BackColor = Color.PeachPuff;
MyFormat.Font = new Font("MS UI Gothic", 10, FontStyle.Bold);
MyFormat.ForeColor = Color.DarkGreen;
MyFormat.Orientation = GrapeCity.Win.Containers.CaptionOrientation.Left;
MyFormat.Size = 80;
MyFormat.Spacing = 10;
MyFormat.TextEffect = GrapeCity.Win.Common.TextEffect.Raised;
MyFormat.TextHAlign = GrapeCity.Win.Common.TextHAlign.Justify;
MyFormat.TextVAlign = GrapeCity.Win.Common.TextVAlign.Middle;
MyFormat.WrapMode = GrapeCity.Win.Common.TextWrapMode.WordWrap;
gcTabPage1.CaptionFormat = MyFormat;
// キャプションの文字を設定します
gcTabPage1.SetCaptionText(textBox1, "キャプション");

個々のコントロールに異なるスタイルを設定する場合

タブページ上の個々のコントロールに異なるスタイルを適用する場合は、GcTabPage.CaptionFormat プロパティを Individual に設定します。また、キャプションのスタイルは GcTabPage.CaptionFormat プロパティが参照する CaptionFormat クラスにより行います。

タブページ上にコントロールを配置したとき、Visual Studio のデザイン画面でそのコントロールのプロパティウィンドウを見ると、次の項目が追加されます。キャプションのスタイルと文字の設定はここで行います。

また、コードで設定を行う場合は、GcTabPage.SetCaptionFormat メソッドでキャプションのスタイルを適用するコントロールを指定します。

Visual Basic
C#

' 個々の子コントロールに異なるキャプションのスタイルを適用します
GcTabPage1.ApplyCaptionFormat = GrapeCity.Win.Containers.ApplyToChild.Individual
' キャプションのスタイルを設定します
Dim MyFormat As GrapeCity.Win.Containers.CaptionFormat = New GrapeCity.Win.Containers.CaptionFormat
MyFormat.BackColor = Color.PeachPuff
MyFormat.Font = New Font("MS UI Gothic", 10, FontStyle.Bold)
MyFormat.ForeColor = Color.DarkGreen
MyFormat.Orientation = GrapeCity.Win.Containers.CaptionOrientation.Left
MyFormat.Size = 80
MyFormat.Spacing = 10
MyFormat.TextEffect = GrapeCity.Win.Common.TextEffect.Raised
MyFormat.TextHAlign = GrapeCity.Win.Common.TextHAlign.Justify
MyFormat.TextVAlign = GrapeCity.Win.Common.TextVAlign.Middle
MyFormat.WrapMode = GrapeCity.Win.Common.TextWrapMode.WordWrap
' 適用するコントロールを指定します
GcTabPage1.SetCaptionFormat(TextBox1, MyFormat)
' キャプションの文字を設定します
GcTabPage1.SetCaptionText(TextBox1, "キャプション")

// 個々の子コントロールに異なるキャプションのスタイルを適用します
gcTabPage1.ApplyCaptionFormat = GrapeCity.Win.Containers.ApplyToChild.Individual;
// キャプションのスタイルを設定します
GrapeCity.Win.Containers.CaptionFormat MyFormat = new GrapeCity.Win.Containers.CaptionFormat();
MyFormat.BackColor = Color.PeachPuff;
MyFormat.Font = new Font("MS UI Gothic", 10, FontStyle.Bold);
MyFormat.ForeColor = Color.DarkGreen;
MyFormat.Orientation = GrapeCity.Win.Containers.CaptionOrientation.Left;
MyFormat.Size = 80;
MyFormat.Spacing = 10;
MyFormat.TextEffect = GrapeCity.Win.Common.TextEffect.Raised;
MyFormat.TextHAlign = GrapeCity.Win.Common.TextHAlign.Justify;
MyFormat.TextVAlign = GrapeCity.Win.Common.TextVAlign.Middle;
MyFormat.WrapMode = GrapeCity.Win.Common.TextWrapMode.WordWrap;
gcTabPage1.CaptionFormat = MyFormat;
// 適用するコントロールを指定します
gcTabPage1.SetCaptionFormat(textBox1, MyFormat);
// キャプションの文字を設定します
gcTabPage1.SetCaptionText(textBox1, "キャプション");

参照