未入力時の表示

テキストコントロールには、未入力のときに代替文字を表示する機能を搭載しています。

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

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

コントロールにフォーカスがあるときのテキストを設定するには、WatermarkBase.Nullプロパティを使用します。コントロールにフォーカスがないときのテキストを設定するには、WatermarkBase.DisplayNullプロパティを使用します。

(図) 代替テキストを表示したテキストコントロール

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

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

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

Visual Basic
C#

' フォーカスがないときの代替テキスト
GcTextBox1.Watermark.DisplayNull.Text = "ひらがなで入力してください。"
GcTextBox1.Watermark.DisplayNull.ForeColor = System.Drawing.Color.Aquamarine

' フォーカスがあるときの代替テキスト
GcTextBox1.Watermark.Null.Text = "必須入力"
GcTextBox1.Watermark.Null.ForeColor = System.Drawing.Color.Gray

// フォーカスがないときの代替テキスト
GcTextBox1.Watermark.DisplayNull.Text = "ひらがなで入力してください。";
GcTextBox1.Watermark.DisplayNull.ForeColor = System.Drawing.Color.Aquamarine;

// フォーカスがあるときの代替テキスト
GcTextBox1.Watermark.Null.Text = "必須入力";
GcTextBox1.Watermark.Null.ForeColor = System.Drawing.Color.Gray;