入力時の書式を設定する入力フィールドには、次の6種類のフィールドが提供されており、これらのフィールドオブジェクトを使って書式を設定することができます。

• DateLiteralField （リテラル文字フィールド）
• DateEraField （年号入力フィールド）
• DateEraYearField （和暦入力フィールド）
• DateYearField （年入力フィールド）
• DateMonthField （月入力フィールド）
• DateDayField （日入力フィールド）

また、表示フィールドでは、次の9種類のフィールドが提供されています。

• DateLiteralDisplayField （リテラル文字表示フィールド）
• DateEraDisplayField （年号表示フィールド）
• DateEraYearDisplayField （和暦表示フィールド）
• DateADDisplayField （西暦表示フィールド）
• DateYearDisplayField （年表示フィールド）
• DateMonthDisplayField （月表示フィールド）
• DateDayDisplayField （日表示フィールド）
• DateWeekdayDisplayField （曜日表示フィールド）
• DateSystemFormatDisplayField （システム書式表示フィールド）

これらのフィールドオブジェクトをDateFieldCollection または、DateDisplayFieldCollection コレクションにに追加することで 日付の書式を作成します。

日付コントロールには時刻部分に関係したフィールドは追加できません。これらのフィールドは、フィールドコレクションエディタでは使用できないようになっています。また、コードから時刻部分に関係したフィールドを追加した場合には、例外が発生します。

日付の書式は、入力および表示用の各フィールドコレクションに、前項で解説したフィールドオブジェクトを組み合わせて作成します。

コードによる設定

入力書式を設定するには、Add またはAddRange メソッドを使用して、DateFieldCollection コレクションに入力用フィールドオブジェクトを追加します。表示書式は、Add またはAddRange メソッドを使用して、表示用フィールドオブジェクトをDateDisplayFieldCollection コレクションに追加します。

次のサンプルコードは、日付コントロールに入力および表示書式を設定する例です。

Imports GrapeCity.Win.Editors
Imports GrapeCity.Win.Editors.Fields

' フィールドをクリアします。
GcDate1.Fields.Clear()
GcDate1.DisplayFields.Clear()

' 入力フィールドのオブジェクトを作成します。
Dim dateYearField1 As New DateYearField(YearDigitType.FourDigitYear)
Dim dateLiteralField1 As New DateLiteralField("/")
Dim dateMonthField1 As New DateMonthField(MonthPattern.Number)
Dim dateLiteralField2 As New DateLiteralField("/")
Dim dateDayField1 As New DateDayField()

' フィールドをコレクションに追加してコントロールに入力書式を設定します。
GcDate1.Fields.AddRange(New DateField() { _
    dateYearField1, dateLiteralField1, dateMonthField1, _
    dateLiteralField2, dateDayField1})

' 表示フィールドのオブジェクトを作成します。
Dim dateYearDisplayDield1 As New DateYearDisplayField(False)
Dim dateLiteralDisplayField1 As New DateLiteralDisplayField("年")
Dim dateMonthDisplayField1 As New DateMonthDisplayField(False)
Dim dateLiteralDisplayField2 As New DateLiteralDisplayField("月")
Dim dateDayDisplayField1 As New DateDayDisplayField(False)
Dim dateLiteralDisplayField3 As New DateLiteralDisplayField("日")

' フィールドをコレクションに追加してコントロールに表示書式を設定します。
GcDate1.DisplayFields.AddRange(New DateDisplayField() { _
    dateYearDisplayDield1, dateLiteralDisplayField1, dateMonthDisplayField1, _
    dateLiteralDisplayField2, dateDayDisplayField1, dateLiteralDisplayField3})

using GrapeCity.Win.Editors;
using GrapeCity.Win.Editors.Fields;

// フィールドをクリアします。
gcDate1.Fields.Clear();
gcDate1.DisplayFields.Clear();

// 入力フィールドのオブジェクトを作成します。
DateYearField dateYearField1 = new DateYearField(YearDigitType.FourDigitYear);
DateLiteralField dateLiteralField1 = new DateLiteralField("/");
DateMonthField dateMonthField1 = new DateMonthField(MonthPattern.Number);
DateLiteralField dateLiteralField2 = new DateLiteralField("/");
DateDayField dateDayField1 = new DateDayField();

// フィールドをコレクションに追加してコントロールに入力書式を設定します。
gcDate1.Fields.AddRange(new DateField[] {
dateYearField1, dateLiteralField1, dateMonthField1,
dateLiteralField2, dateDayField1});

// 表示フィールドのオブジェクトを作成します。
DateYearDisplayField dateYearDisplayDield1 = new DateYearDisplayField(false);
DateLiteralDisplayField dateLiteralDisplayField1 = new DateLiteralDisplayField("年");
DateMonthDisplayField dateMonthDisplayField1 = new DateMonthDisplayField(false);
DateLiteralDisplayField dateLiteralDisplayField2 = new DateLiteralDisplayField("月");
DateDayDisplayField dateDayDisplayField1 = new DateDayDisplayField(false);
DateLiteralDisplayField dateLiteralDisplayField3 = new DateLiteralDisplayField("日");

// フィールドをコレクションに追加してコントロールに表示書式を設定します。
gcDate1.DisplayFields.AddRange(new DateDisplayField[] {
dateYearDisplayDield1, dateLiteralDisplayField1,  dateMonthDisplayField1, 
dateLiteralDisplayField2, dateDayDisplayField1, dateLiteralDisplayField3});

　　　
(図) 上記サンプルコードを適用したコントロール

フィールドオブジェクトをDateFieldCollection または DateDisplayFieldCollection コレクションから削除するには、Remove メソッドまたは、RemoveAt メソッドを使用します。

次のサンプルコードは、DateFieldCollection コレクションの先頭のフィールドを削除する例です。

' コレクションの先頭のオブジェクトを削除します。
GcDate1.Fields.RemoveAt(0)

// コレクションの先頭のオブジェクトを削除します。
gcDate1.Fields.RemoveAt(0);

デザイン画面での設定

デザイン画面ではフィールドオブジェクトを設定できる「入力フィールドの編集」「表示フィールドの編集」エディタから容易な設定が可能です。 このエディタは次のいずれかの方法で起動でき、日付コントロールで設定可能なフィールドを組み合わせて設定します。

• プロパティページの「書式設定」-「入力フィールド」を選択
• コントロールのスマート タグから「入力フィールドの編集...」を選択
• プロパティウィンドウのFields プロパティをアクティブにした時に表示される「…」ボタンを押下

• プロパティページの「書式設定」-「表示フィールド」を選択
• コントロールのスマート タグから「表示フィールドの編集...」を選択
• プロパティウィンドウのDisplayFields プロパティをアクティブした時に表示される「…」ボタンを押下

このエディタでは、コレクションにフィールドを追加や編集すると同時に各フィールドのテキストのフォントや色といったスタイルを設定することができます。

（図）フィールド毎に異なったスタイルを設定

ここでは、日付コントロールの入力フィールドに設定可能な6種類のフィールドについて、すべてのフィールドに共通な設定項目と各フィールドに特化した設定項目にわけて解説します。

すべてのフィールドクラスに共通な設定

これらのプロパティは、日付コントロールのすべての入力フィールドオブジェクトに共通な設定項目です。

リテラル文字フィールド (DateLiteralField)

リテラル文字フィールド（DateLiteralField クラス）は、コントロールに表示するリテラル文字を設定します。

年号入力フィールド (DateEraField)

年号入力フィールド (DateEraField クラス）は和暦表示時の年号を入力するフィールドです。

和暦入力フィールド (DateEraYearField)

和暦入力フィールド (DateEraYearField クラス）は、和暦年を入力するフィールドです。

年入力フィールド (DateYearField)

年入力フィールド (DateYearField クラス）は、西暦の年を入力するフィールドです。

月入力フィールド (DateMonthField)

月入力フィールド (DateMonthField クラス）は、月を入力するフィールドです。

日入力フィールド (DateDayField)

日入力フィールド (DateDayField クラス）は、日を入力するフィールドです。

ここでは、日付コントロールの表示フィールドに設定可能な9種類のフィールドについて、すべてのフィールドに共通な設定項目と各フィールドに特化した設定項目にわけて解説します。

すべてのフィールドクラスに共通な設定

これらのプロパティは、日付コントロールのすべての表示フィールドオブジェクトに共通な設定項目です。

リテラル文字表示フィールド (DateLiteralDisplayField)

リテラル文字表示フィールド (DateLiteralDisplayField クラス）は、コントロールに表示するリテラル文字を設定します。

年号表示フィールド (DateEraDisplayField)

年号表示フィールド (DateEraDisplayField クラス）は、和暦表示時の年号を表示するフィールドです。

和暦表示フィールド (DateEraYearDisplayField)

和暦表示フィールド (DateEraYearDisplayField クラス）は、和暦年を表示するフィールドです。

西暦表示フィールド (DateADDisplayField)

西暦表示フィールド (DateADDisplayField クラス）は、紀元後を表すA.D.を表示するフィールドです。

年表示フィールド (DateYearDisplayField)

年表示フィールド (DateYearDisplayField クラス）は、西暦の年を表示するフィールドです。

月表示フィールド (DateMonthDisplayField)

月表示フィールド (DateMonthDisplayField クラス）は、月を表示するフィールドです。

日表示フィールド (DateDayDisplayField)

日表示フィールド (DateDayDisplayField クラス）は、日を表示するフィールドです。

曜日表示フィールド (DateWeekdayDisplayField)

曜日表示フィールド (DateWeekdayDisplayField クラス）は、曜日を表示するフィールドです。

システム書式表示フィールド (DateSystemFormatDisplayField)

システム書式表示フィールド (DateSystemFormatDisplayField クラス）は、 システムで定義された書式指定子を使用して日付または時刻の書式を設定します。

日付コントロールの時刻値は常に深夜の 12 時 (00:00:00)です。