AlternateText プロパティを使用すれば、セルが未入力のときに代わりに表示するテキストを文字列として設定することができます。

セルが編集状態のときのテキストを設定するには、TextBoxAlternateTextInfo クラスのNull プロパティを使用します。セルが非編集状態のときのテキストを設定するには、DisplayNull プロパティを使用します。

これらの２つのプロパティでは、次の2つを設定することができます。

• ForeColor プロパティ（テキストの前景色）
• Text プロパティ（表示するテキスト）

サンプルコード

GrapeCity.Win.Spread.InputMan.CellType.GcTextBoxCellType gcTextBoxCell1 = new GrapeCity.Win.Spread.InputMan.CellType.GcTextBoxCellType();
// 非編集状態の代替テキストを設定
gcTextBoxCell1.AlternateText.DisplayNull.Text = "氏名を入力してください。";
gcTextBoxCell1.AlternateText.DisplayNull.ForeColor = Color.Gray;
// 編集状態の代替テキストを設定
gcTextBoxCell1.AlternateText.Null.Text = "全角文字で入力してください。";
gcTextBoxCell1.AlternateText.Null.ForeColor = Color.Pink;
fpSpread1.ActiveSheet.Cells[0, 0].CellType = gcTextBoxCell1;

Dim gcTextBoxCell1 As New GrapeCity.Win.Spread.InputMan.CellType.GcTextBoxCellType()
' 非編集状態の代替テキストを設定
gcTextBoxCell1.AlternateText.DisplayNull.Text = "氏名を入力してください。"
gcTextBoxCell1.AlternateText.DisplayNull.ForeColor = Color.Gray
' 編集状態の代替テキストを設定
gcTextBoxCell1.AlternateText.Null.Text = "全角文字で入力してください。"
gcTextBoxCell1.AlternateText.Null.ForeColor = Color.Pink
FpSpread1.ActiveSheet.Cells(0, 0).CellType = gcTextBoxCell1

ShowRecommendedValue プロパティを使用すると、テキストコントロールで値が未入力のとき、入力候補となる値をグレー表示することができます。入力候補として表示されたテキストの値は、表示された候補値のまま適用するか、全ての値を変更して入力値として適用することができます。入力候補として表示される値は、RecommendedValue プロパティで設定します。

候補値を表示可能な他のコントロールでは、ショートカットコンポーネントのショートカットキーとして、デフォルトで[Ctrl]+[Enter]キーに対して候補値を確定する動作が定義されます。これにより他のコントロールでは[Ctrl]+[Enter]キーを押下することで値を確定できますが、テキストコントロールについてはデフォルトでキーが定義されないため、[Ctrl]+[Enter]キーを押下しても値を確定できません。

キーを押下して値を確定するためには、コントロールのショートカット機能に、手動で任意のキーに対してApplyRecommendedValue を追加してください。[Ctrl]+[Enter]キーに対して設定することも可能です。

候補値の一部の値だけを変更することはできません。 RecommendedValueプロパティは複数行テキストでは機能しません。

(図) 入力候補値を変更せずに値を確定

セルに割り当てられた文字列が列幅に収まりきらないときに、すべての文字が表示されていないことを示す省略文字を表示することができます。省略文字を表示の有無やその表示位置は、Ellipsis プロパティで設定することができます。

Multiline プロパティをTrueに設定して複数行表示した場合、省略文字はセルに表示されている最終行に表示されます。

省略文字は、既定値では３点リーダー（…）で表示されます。任意の文字に表示を変更する場合は、EllipsisString プロパティを使用します。