SPREAD for WPF 3.0J - GcSpreadGrid
ヘッダテキスト
GrapeCity SPREAD for WPF 3.0J > 開発者ガイド > ヘッダ > ヘッダテキスト

既定では、列ヘッダに連続したアルファベット、行ヘッダに連続した数字が自動的に表示されます。これらのテキストは、列ヘッダが複数行の場合には最終行に、行ヘッダが複数列の場合は最終列に表示されます。

既定のヘッダ テキスト

ヘッダテキストの表示位置

テキストを最終行や最終列以外の位置に表示することもできます。複数行の列ヘッダの何行目に表示するかは、列ヘッダの AutoTextIndex プロパティに設定します。複数列の行ヘッダの何列目に表示するかは、行ヘッダの AutoTextIndex プロパティに設定します。

ヘッダテキストの表示内容

表示内容は列ヘッダの AutoText プロパティ、および行ヘッダの AutoText プロパティで設定できます。設定値は次のとおりです。

AutoText の値 説明
Blank 何も表示しません。
Numbers 連続した数字を表示します。
Letters 連続したアルファベットを表示します。
コントロールをデータソースに連結すると、列ヘッダにはデータソースのフィールド名が設定されます。詳しくは「列のカスタマイズ」を参照してください。

ヘッダテキストのカスタマイズ

ヘッダセルに任意のテキストを設定することができます。 ヘッダ セルにテキストを設定するには、列ヘッダおよび行ヘッダのセルの Text または Value プロパティを使用する方法があります。また、列ヘッダには列の Header プロパティを使用する方法があります。それぞれの方法について説明します。

列ヘッダおよび行ヘッダセルの Text および Value プロパティ

次の図では列ヘッダの3行1列目と、行ヘッダの1行2列目にテキストを設定しています。

ヘッダ テキストのカスタマイズ

コントロールの ColumnHeader プロパティで列ヘッダを、RowHeader プロパティで行ヘッダを参照します。そして、インデックスを指定してヘッダ セルを参照し Text または Value プロパティに表示したいテキストを設定します。

次のサンプルコードは列ヘッダの3行1列目と、行ヘッダの1行2列目にテキストを設定します。

C#
コードのコピー
gcSpreadGrid1.ColumnHeader.RowCount = 3;
gcSpreadGrid1.ColumnHeader[2, 0].Text = "Name";
gcSpreadGrid1.RowHeader.ColumnCount = 2;
gcSpreadGrid1.RowHeader[0, 1].Text = "No.1";
Visual Basic
コードのコピー
GcSpreadGrid1.ColumnHeader.RowCount = 3
GcSpreadGrid1.ColumnHeader(2, 0).Text = "Name"
GcSpreadGrid1.RowHeader.ColumnCount = 2
GcSpreadGrid1.RowHeader(0, 1).Text = "No.1"

列の Header プロパティ

列の Header プロパティに設定されたテキストは、列ヘッダに表示されます。複数行の列ヘッダの場合、設定したテキストはヘッダテキストの表示位置を表す AutoTextIndex プロパティで指定された行に表示されます。

次のサンプルコードは1列目のヘッダにテキストを設定します。

C#
コードのコピー
gcSpreadGrid1.Columns[0].Header = "Name";
Visual Basic
コードのコピー
GcSpreadGrid1.Columns(0).Header = "Name"

ヘッダテキストの改行

ヘッダテキストの任意の位置に、改行コードを挿入することで、ヘッダテキストの改行表示が可能です。
また、ヘッダ幅に応じて自動的に折り返すには、セル型の TextWrapping プロパティを使用します。

次のサンプルコードは、1行目のヘッダに改行コードを挿入し、1列目のヘッダは列幅に合わせて折り返すように設定します。

C#
コードのコピー
gcSpreadGrid1.RowHeader[0, 0].Text = "ABC" + Environment.NewLine + "DEF";
gcSpreadGrid1.ColumnHeader[0, 0].CellType = new GrapeCity.Windows.SpreadGrid.GeneralCellType() { TextWrapping = TextWrapping.Wrap };
gcSpreadGrid1.ColumnHeader[0, 0].Text = "ABCDEFGHIJKLMN";
Visual Basic
コードのコピー
GcSpreadGrid1.RowHeader(0, 0).Text = "ABC" + Environment.NewLine + "DEF"
GcSpreadGrid1.ColumnHeader(0, 0).CellType = New GrapeCity.Windows.SpreadGrid.GeneralCellType() With {.TextWrapping = TextWrapping.Wrap}
GcSpreadGrid1.ColumnHeader(0, 0).Text = "ABCDEFGHIJKLMN"
関連トピック