複数行テキスト(GcTextBox型セル)

GcTextBox型セルのMultiline プロパティをTrueに設定すると、複数行の入力が可能なマルチラインモードになります。ここではマルチラインモードの機能について解説します。

ワードラップ

WrapMode プロパティを使用すると、コントロールの幅よりも長いの行の折り返し方法を設定することができます。

WrapMode プロパティには次の３つのモードがあります。

※Multiline プロパティがTrueの場合のみ有効です。GcTextBox型セルはMultiline プロパティがFalseの場合、セル内で文字列を折り返すことはできません。

WrapModeの値	説明
NoWrap	改行しません。
WordWrap	単語単位で改行します。
CharWrap	文字単位で改行します。

CharWrapに設定すると行のスペースがなくなった位置で折り返されるため、意図しない位置での改行を防ぎます。半角・全角の文字が混在した日本語の文章を表示するのに適した改行方法といえます。

行間のスペース

LineSpace プロパティを使用すると、行間の幅（スペース）を設定することができます。行間はピクセル単位で設定します。

罫線の表示

GridLine プロパティが参照するLine構造体を使用して行間に罫線を表示することができます。

罫線を表示したマルチラン

Line構造体の次の２つのプロパティで罫線の線種と色を設定することができます。

Color プロパティ（罫線の色を設定）
Style プロパティ（罫線の線種を設定）

サンプルコード

次のサンプルコードは、罫線を表示したマルチラインテキストの例です。

C#	コードのコピー
GrapeCity.Win.Spread.InputMan.CellType.GcTextBoxCellType gtcell = new GrapeCity.Win.Spread.InputMan.CellType.GcTextBoxCellType(); gtcell.Multiline = true; // 文字単位で改行するよう設定します。 gtcell.WrapMode = GrapeCity.Win.Spread.InputMan.CellType.WrapMode.CharWrap; // 点線で赤の罫線を表示するよう設定します。 gtcell.GridLine.Style = GrapeCity.Win.Spread.InputMan.CellType.LineStyle.Dashed; gtcell.GridLine.Color = Color.Red;

コードのコピー

GrapeCity.Win.Spread.InputMan.CellType.GcTextBoxCellType gtcell = new GrapeCity.Win.Spread.InputMan.CellType.GcTextBoxCellType();
gtcell.Multiline = true;
// 文字単位で改行するよう設定します。
gtcell.WrapMode = GrapeCity.Win.Spread.InputMan.CellType.WrapMode.CharWrap;
// 点線で赤の罫線を表示するよう設定します。
gtcell.GridLine.Style = GrapeCity.Win.Spread.InputMan.CellType.LineStyle.Dashed;
gtcell.GridLine.Color = Color.Red;

Visual Basic	コードのコピー
Dim gtcell = New GrapeCity.Win.Spread.InputMan.CellType.GcTextBoxCellType() gtcell.Multiline = True ' 文字単位で改行するよう設定します。 gtcell.WrapMode = GrapeCity.Win.Spread.InputMan.CellType.WrapMode.CharWrap ' 点線で赤の罫線を表示するよう設定します。 gtcell.GridLine.Style = GrapeCity.Win.Spread.InputMan.CellType.LineStyle.Dashed gtcell.GridLine.Color = Color.Red

Visual Basic

コードのコピー

Dim gtcell = New GrapeCity.Win.Spread.InputMan.CellType.GcTextBoxCellType()
gtcell.Multiline = True
' 文字単位で改行するよう設定します。
gtcell.WrapMode = GrapeCity.Win.Spread.InputMan.CellType.WrapMode.CharWrap
' 点線で赤の罫線を表示するよう設定します。
gtcell.GridLine.Style = GrapeCity.Win.Spread.InputMan.CellType.LineStyle.Dashed
gtcell.GridLine.Color = Color.Red

入力行数の制限

MaxLineCount プロパティを使用して、コントロールに入力可能な行数を制限することができます。

MaxLineCount プロパティに 0 以外の値を設定した場合、設定した値よりも後の行には入力ができなくなります。値が 0 の場合は行数に制限はありません。

行数を制限する際には、GcTextBoxEditingControl.CountWrappedLineプロパティで、ワードラップによる自動改行を考慮するかどうかを設定できます。このプロパティはセルの編集時のみ有効です。このプロパティがTrueに設定された場合は、ワードラップによる自動改行は１行としてカウントされます。つまり、表示上の行数により入力が制限されるようになります。一方、CountWrapedLineプロパティがFalseに設定されている場合は、改行コードによる改行のみカウントされます。

スクロールバー

セルの編集時のみ有効です。

Multiline プロパティをTrueに設定して GcTextBoxCell を複数行にすると、スクロールバーを表示することができます。表示するスクロールバーの種類は、ScrollBars プロパティで設定します。