MESCIUS SPREAD for Windows Forms 17.0J > 開発者ガイド > セル型 > InputManセル > GcTextBox型セル > 複数行テキスト(GcTextBox型セル) |
GcTextBox型セルのMultiline プロパティをTrueに設定すると、複数行の入力が可能なマルチラインモードになります。ここではマルチラインモードの機能について解説します。
WrapMode プロパティを使用すると、コントロールの幅よりも長いの行の折り返し方法を設定することができます。
WrapMode プロパティには次の3つのモードがあります。
※Multiline プロパティがTrueの場合のみ有効です。GcTextBox型セルはMultiline プロパティがFalseの場合、セル内で文字列を折り返すことはできません。
WrapModeの値 | 説明 |
---|---|
NoWrap | 改行しません。 |
WordWrap | 単語単位で改行します。 |
CharWrap | 文字単位で改行します。 |
CharWrapに設定すると行のスペースがなくなった位置で折り返されるため、意図しない位置での改行を防ぎます。半角・全角の文字が混在した日本語の文章を表示するのに適した改行方法といえます。
LineSpace プロパティを使用すると、行間の幅(スペース)を設定することができます。行間はピクセル単位で設定します。
GridLine プロパティが参照するLine構造体を使用して行間に罫線を表示することができます。
Line構造体の次の2つのプロパティで罫線の線種と色を設定することができます。
次のサンプル コードは、罫線を表示したマルチラインテキストの例です。
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; |
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に設定された場合は、ワードラップによる自動改行は1行としてカウントされます。つまり、表示上の行数により入力が制限されるようになります。一方、CountWrapedLineプロパティがFalseに設定されている場合は、改行コードによる改行のみカウントされます。
セルの編集時のみ有効です。
Multiline プロパティをTrueに設定して GcTextBoxCell を複数行にすると、スクロールバーを表示することができます。表示するスクロールバーの種類は、ScrollBars プロパティで設定します。