未入力時の表示

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

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

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

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

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

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

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

Visual Basic
C#

' フォーカスがないときの代替テキスト
GcTime1.Watermark.DisplayNull.Text = "出勤時刻"
GcTime1.Watermark.DisplayNull.ForeColor = System.Drawing.Color.LimeGreen

' フォーカスがあるときの代替テキスト
GcTime1.Watermark.Null.Text = "直行は00:00を入力"
GcTime1.Watermark.Null.ForeColor = System.Drawing.Color.Coral

// フォーカスがないときの代替テキスト
GcTime1.Watermark.DisplayNull.Text = "出勤時刻";
GcTime1.Watermark.DisplayNull.ForeColor = System.Drawing.Color.LimeGreen;

// フォーカスがあるときの代替テキスト
GcTime1.Watermark.Null.Text = "直行は00:00を入力";
GcTime1.Watermark.Null.ForeColor = System.Drawing.Color.Coral;

プロンプト文字

フィールドに何も入力されていないときに表示するプロンプト文字は、PromptCharプロパティを使用して設定します。プロンプト文字は、TimeFormat.Patternプロパティで定義された書式の入力位置にプレースホルダとして表示され、ユーザに入力を促します。なお、PromptCharプロパティには、半角または全角の文字を設定できますが、文字列は設定できません。

（図）プロンプト文字（"_"）

代替テキストを設定している場合、コントロールに文字が入力されていないときには代替テキストの設定が優先されます。未入力時に、TimeFormat.Patternプロパティで設定したリテラル文字列を含む書式とプロンプト文字を表示するには、次のサンプルコードのように、代替テキストを空の文字列に設定します。

Visual Basic
C#

GcTime1.Watermark.DisplayNull.Text = String.Empty
GcTime1.Watermark.Null.Text = String.Empty
GcTime1.PromptChar = '_'

GcTime1.Watermark.DisplayNull.Text = string.Empty;
GcTime1.Watermark.Null.Text = string.Empty;
GcTime1.PromptChar = '_';