Watermark プロパティ (GcDateTime)

コントロールが未入力のときや和暦表示できない日付が設定された場合に表示される代替テキストを設定します。

構文

Visual Basic (宣言)
C#

Public Shadows ReadOnly Property Watermark As DateWatermark

public new DateWatermark Watermark {get;}

プロパティ値

代替テキストを設定するGrapeCity.Web.Input.Core.DateWatermark型。

解説

コントロールのValueプロパティの値がNothing（null）のときおよび、和暦表示できない日付のときに表示される代替テキストを設定することができます。代替テキストには文字列と文字色を設定でき、またコントロールに入力フォーカスがある場合とない場合のそれぞれの代替テキストを表示できます。和暦表示が可能な日付の範囲は、1868年9月8日～2087年12月31日です。

使用例

以下のサンプルコードは、日付時刻コントロールに代替テキストを設定します。

Visual Basic
C#

' フォーカスがないとき代替テキストを設定します。
GcDateTime1.Watermark.DisplayNull.Text = "必須入力です。"
GcDateTime1.Watermark.DisplayNull.ForeColor = System.Drawing.Color.LightGray
GcDateTime1.Watermark.DisplayEmptyEra.Text = "和暦表示できない日付です。"
GcDateTime1.Watermark.DisplayEmptyEra.ForeColor = System.Drawing.Color.LightGray

' フォーカス取得時の代替テキストを設定します。
GcDateTime1.Watermark.EmptyEra.Text = "1868/9/8以降の日付を入力してください。"
GcDateTime1.Watermark.EmptyEra.ForeColor = System.Drawing.Color.LightPink
GcDateTime1.Watermark.Null.Text = "日付を入力してください。"
GcDateTime1.Watermark.Null.ForeColor = System.Drawing.Color.LightPink

// フォーカスがないときの代替テキストを設定します。
GcDateTime1.Watermark.DisplayNull.Text = "必須入力です。";
GcDateTime1.Watermark.DisplayNull.ForeColor = System.Drawing.Color.LightGray;
GcDateTime1.Watermark.DisplayEmptyEra.Text = "和暦表示できない日付です。";
GcDateTime1.Watermark.DisplayEmptyEra.ForeColor = System.Drawing.Color.LightGray;

// フォーカス取得時の代替テキストを設定します。
GcDateTime1.Watermark.EmptyEra.Text = "1868/9/8以降の日付を入力してください。";
GcDateTime1.Watermark.EmptyEra.ForeColor = System.Drawing.Color.LightPink;
GcDateTime1.Watermark.Null.Text = "日付を入力してください。";
GcDateTime1.Watermark.Null.ForeColor = System.Drawing.Color.LightPink;

参照

GcDateTime クラス
 GcDateTime メンバ