視覚的な補助

GcNumberCellでは様々な視覚的な補助機能を提供しています。この章ではそれらの機能について解説します。

未入力時に表示する代替テキスト

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

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

AlternateTextプロパティは、NumberAlternateTextオブジェクトを参照し、NumberAlternateTextクラスのプロパティを使用して以下の代替テキストを設定できます。

プロパティ	代替テキストの内容
DisplayNull	セルにフォーカスがなく、未入力のときの代替テキスト
DisplayZero	セルにフォーカスがなく、値が0のときの代替テキスト
Null	セルにフォーカスがあり、未入力のときの代替テキスト
Zero	セルにフォーカスがあり、値が0のときの代替テキスト

これらのプロパティはAlternateTextクラスを参照し、次の2つを設定することができます。

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

Visual Basic
C#

Imports GrapeCity.Win.MultiRow
Imports InputManCell = GrapeCity.Win.MultiRow.InputMan

Dim GcNumberCell1 = New InputManCell.GcNumberCell()
GcNumberCell1.Size = New Size(180, 20)

' フォーカスがないときの代替テキスト
GcNumberCell1.AlternateText.DisplayNull.Text = "金額を入力してください"
GcNumberCell1.AlternateText.DisplayNull.ForeColor = System.Drawing.Color.LightSeaGreen
GcNumberCell1.AlternateText.DisplayZero.Text = "0円です。"
GcNumberCell1.AlternateText.DisplayZero.ForeColor = System.Drawing.Color.Gray

' フォーカスがあるときの代替テキスト
GcNumberCell1.AlternateText.Null.Text = "税込で入力してください"
GcNumberCell1.AlternateText.Null.ForeColor = System.Drawing.Color.LightPink
GcNumberCell1.AlternateText.Zero.Text = "0円は無効です"
GcNumberCell1.AlternateText.Zero.ForeColor = System.Drawing.Color.Red

GcMultiRow1.Template = Template.CreateGridTemplate(New Cell() {GcNumberCell1})

using GrapeCity.Win.MultiRow;
using InputManCell = GrapeCity.Win.MultiRow.InputMan;

InputManCell.GcNumberCell gcNumberCell1 = new InputManCell.GcNumberCell();
gcNumberCell1.Size = new Size(180, 20);

// フォーカスがないときの代替テキスト
gcNumberCell1.AlternateText.DisplayNull.Text = "金額を入力してください";
gcNumberCell1.AlternateText.DisplayNull.ForeColor = System.Drawing.Color.LightSeaGreen;
gcNumberCell1.AlternateText.DisplayZero.Text = "0円です。";
gcNumberCell1.AlternateText.DisplayZero.ForeColor = System.Drawing.Color.Gray;

// フォーカスがあるときの代替テキスト
gcNumberCell1.AlternateText.Null.Text = "税込で入力してください";
gcNumberCell1.AlternateText.Null.ForeColor = System.Drawing.Color.LightPink;
gcNumberCell1.AlternateText.Zero.Text = "0円は無効です";
gcNumberCell1.AlternateText.Zero.ForeColor = System.Drawing.Color.Red;

gcMultiRow1.Template = Template.CreateGridTemplate(new Cell[] { gcNumberCell1 });

入力候補値の表示

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

候補として表示された値を確定するには、[Ctrl]+[Enter]キーを押下します。

GcTextBoxCell、GcCharMaskCell、GcNumberCell、GcComboBoxCell では候補値の一部の値だけを変更することはできません。

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

ハイライト表示

HighlightTextプロパティを使用すると、フォーカスを受け取ったときのテキストの選択状態を設定することができます。