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

(図) 代替テキストを表示したGcTextBoxCell

AlternateTextプロパティは、TextBoxAlternateTextクラスを参照します。セルにフォーカスがあるときのテキストを設定するには、TextBoxAlternateTextクラスのNullプロパティを、セルにフォーカスがないときのテキストを設定するには、TextBoxAlternateTextクラスのDisplayNullプロパティを使用します。これらのプロパティはAlternateTextクラスを参照し、次の2つを設定することができます。

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

次のサンプルコードは、代替テキストを設定する例です。

Imports GrapeCity.Win.MultiRow
Imports InputManCell = GrapeCity.Win.MultiRow.InputMan
                                                                
Dim GcTextBoxCell1 As New InputManCell.GcTextBoxCell()

GcTextBoxCell1.Name = "GcTextBoxCell1"
' フォーカスがないときの代替テキストを設定します。
GcTextBoxCell1.AlternateText.DisplayNull.Text = "氏名を入力してください。"
GcTextBoxCell1.AlternateText.DisplayNull.ForeColor = Color.Gray
' 入力中の代替テキストを設定します。
GcTextBoxCell1.AlternateText.Null.Text = "全角文字で入力してください。"
GcTextBoxCell1.AlternateText.Null.ForeColor = Color.Pink

GcMultiRow1.Template = Template.CreateGridTemplate(New Cell() {GcTextBoxCell1})
GcMultiRow1.RowCount = 3

using GrapeCity.Win.MultiRow;
using InputManCell = GrapeCity.Win.MultiRow.InputMan;
                                                                
InputManCell.GcTextBoxCell gcTextBoxCell1 = new InputManCell.GcTextBoxCell();

gcTextBoxCell1.Name = "gcTextBoxCell1";

// フォーカスがないときの代替テキストを設定します。
gcTextBoxCell1.AlternateText.DisplayNull.Text = "氏名を入力してください。";
gcTextBoxCell1.AlternateText.DisplayNull.ForeColor = Color.Gray;
// 入力中の代替テキストを設定します。
gcTextBoxCell1.AlternateText.Null.Text = "全角文字で入力してください。";
gcTextBoxCell1.AlternateText.Null.ForeColor = Color.Pink;

gcMultiRow1.Template = Template.CreateGridTemplate(new Cell[] { gcTextBoxCell1 });
gcMultiRow1.RowCount = 3;
                            

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

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

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

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

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