CalendarGcTextBoxCellTypeでは様々な視覚的な補助機能を提供しています。この章ではそれらの機能について解説します。
未入力時に表示する代替テキスト
AlternateTextプロパティを使用すれば、セルが未入力（CalendarCell.Value プロパティ）のときに代わりに表示するテキストを文字列として設定することができます。AlternateTextは、TextBoxAlternateTextオブジェクトを参照するプロパティです。
セルにフォーカスがあるときのテキストを設定するには、TextBoxAlternateText.Nullプロパティを使用します。セルにフォーカスがないときのテキストを設定するには、TextBoxAlternateText.DisplayNullプロパティを使用します。
(図) 代替テキストを表示したCalendarGcTextBoxCellType
これらの２つのプロパティでは、次の2つを設定することができます。
入力候補値の表示
ShowRecommendedValueプロパティを使用すると、CalendarGcTextBoxCellTypeで値が未入力のとき、入力候補となる値をグレー表示することができます。
入力候補として表示されたテキストの値は、表示された候補値のまま適用するか、全ての値を変更して入力値として適用することができます。
入力候補として表示される値は、RecommendedValueプロパティで設定します。
 |
注意 CalendarGcTextBoxCellType、CalendarGcMaskCellType、CalendarGcNumberCellType、CalendarGcComboBoxCellTypeでは候補値の一部の値だけを変更することはできません。 RecommendedValueプロパティは複数行テキストでは機能しません。 |
ハイライト表示
HighlightTextプロパティを使用すると、フォーカスを受け取ったときに、セルのすべてのテキストを選択状態にできます。
省略文字
Textプロパティに割り当てられた文字列がセルの幅に収まりきらないときに、すべての文字が表示されていないことを示す省略文字を表示することができます。省略文字を表示の有無やその表示位置は、Ellipsisプロパティで設定することができます。
| Ellipsisの値 | 説明 |
|---|---|
|
None |
省略文字を表示しません。 |
|
EllipsisEnd |
セルの右側に省略文字を表示します。 |
|
EllipsisPath |
セルの中央に省略文字を表示します。 |
省略文字は、既定値では３点リーダー（…）で表示されます。任意の文字に表示を変更する場合は、EllipsisStringプロパティを使用します。