未入力時の表示

数値コントロールでは未入力のときや入力が完了していないとき、様々な補助機能を提供しています。この章ではそれらの機能について解説します。

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

Watermarkプロパティを使用すれば、コントロールが未入力のときや値がゼロのときに代わりに表示するテキスト（ウォーターマーク）を設定することができます。 Watermarkプロパティは、NumberWatermarkオブジェクトを参照し、 NumberWatermarkオブジェクトのプロパティを使用して以下の代替テキストを設定できます。

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

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

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

（図）代替テキストを表示した日付時刻コントロール

次のサンプルコードは、上図のような代替テキストを表示する方法です。

Visual Basic
C#

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

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

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

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

参照