ここでは、フィールドオブジェクトによる書式設定について説明します。
概要
GcDateTimeCellには、表示にInputManのGcDate コントロールのフィールドオブジェクトのサブセットが提供されます。
入力時の書式を設定する入力フィールドには、次の11種類のフィールドが提供されており、これらのフィールドオブジェクトを使って書式を設定することができます。
- DateLiteralField (リテラル文字フィールド)
- DateEraField (年号入力フィールド)
- DateEraYearField (和暦入力フィールド)
- DateYearField (年入力フィールド)
- DateMonthField (月入力フィールド)
- DateDayField (日入力フィールド)
- DateAmPmField (午前／午後入力フィールド )
- DateShortHourField (12時間制時刻入力フィールド)
- DateHourField (時間入力フィールド)
- DateMinuteField (分入力フィールド)
- DateSecondField (秒入力フィールド)
表示フィールドでは、次の14種類のフィールドが提供されています。
- DateLiteralDisplayField (リテラル文字表示フィールド)
- DateEraDisplayField (年号表示フィールド)
- DateEraYearDisplayField (和暦表示フィールド)
- DateADDisplayField (西暦表示フィールド)
- DateYearDisplayField (年表示フィールド）
- DateMonthDisplayField (月表示フィールド)
- DateDayDisplayField (日表示フィールド)
- DateWeekdayDisplayField (曜日表示フィールド)
- DateAmPmDisplayField (午前／午後表示フィールド)
- DateShortHourDisplayField (12時間制時刻表示フィールド)
- DateHourDisplayField (時刻表示フィールド)
- DateMinuteDisplayField (分表示フィールド)
- DateSecondDisplayField (秒表示フィールド)
- DateSystemFormatDisplayField (システム書式表示フィールド)
これらのフィールドオブジェクトをDateTimeFieldCollectionまたは、DateTimeDisplayFieldCollectionコレクションに追加することで 日付時刻の書式を作成します。
フィールドの追加と削除
GcDateTimeCellの書式は、入力および表示用の各フィールドコレクションに、前項で解説したフィールドオブジェクトを組み合わせて作成します。
コードによる設定
入力書式を設定するには、AddまたはAddRangeメソッドを使用して、DateTimeFieldCollectionコレクションに入力用フィールドオブジェクトを追加します。表示書式は、AddまたはAddRangeメソッドを使用して、表示用フィールドオブジェクトをDateTimeDisplayFieldCollectionコレクションに追加します。
次のサンプルコードは、GcDateTimeCellに入力書式を設定する例です。
Imports GrapeCity.Win.MultiRow Imports InputManCell = GrapeCity.Win.MultiRow.InputMan Dim GcDateTimeCell1 As New InputManCell.GcDateTimeCell() GcDateTimeCell1.Name = "GcDateTimeCell1" GcDateTimeCell1.Size = New Size(180, 20) ' フィールドをクリアします。 GcDateTimeCell1.Fields.Clear() GcDateTimeCell1.DisplayFields.Clear() ' 入力フィールドのオブジェクトを作成します。 Dim DateYearField1 As New InputManCell.DateYearField(GrapeCity.Win.Editors.YearDigitType.FourDigitYear) Dim DateLiteralField1 As New InputManCell.DateLiteralField("/") Dim DateMonthField1 As New InputManCell.DateMonthField(GrapeCity.Win.Editors.MonthPattern.Number) Dim DateLiteralField2 As New InputManCell.DateLiteralField("/") Dim DateDayField1 As New InputManCell.DateDayField() Dim DateLiteralField3 As New InputManCell.DateLiteralField(" ") Dim DateHourField1 As New InputManCell.DateHourField() Dim DateLiteralField4 As New InputManCell.DateLiteralField(":") Dim DateMinuteField1 As New InputManCell.DateMinuteField() Dim DateLiteralField5 As New InputManCell.DateLiteralField(":") Dim DateSecondField1 As New InputManCell.DateSecondField() ' フィールドをコレクションに追加してセルに入力書式を設定します。 GcDateTimeCell1.Fields.AddRange(New InputManCell.DateField() { _ DateYearField1, DateLiteralField1, DateMonthField1, _ DateLiteralField2, DateDayField1, DateLiteralField3, _ DateHourField1, DateLiteralField4, DateMinuteField1, _ DateLiteralField5, DateSecondField1}) ' 表示フィールドのオブジェクトを作成します。 Dim DateYearDisplayDield1 As New InputManCell.DateYearDisplayField(False) Dim DateLiteralDisplayField1 As New InputManCell.DateLiteralDisplayField("年") Dim DateMonthDisplayField1 As New InputManCell.DateMonthDisplayField(False) Dim DateLiteralDisplayField2 As New InputManCell.DateLiteralDisplayField("月") Dim DateDayDisplayField1 As New InputManCell.DateDayDisplayField(False) Dim DateLiteralDisplayField3 As New InputManCell.DateLiteralDisplayField("日 ") Dim DateHourDisplayField1 As New InputManCell.DateHourDisplayField(False, False) Dim DateLiteralDisplayField4 As New InputManCell.DateLiteralDisplayField("時") Dim DateMinuteDisplayField1 As New InputManCell.DateMinuteDisplayField(False) Dim DateLiteralDisplayField5 As New InputManCell.DateLiteralDisplayField("分") Dim DateSecondDisplayField1 As New InputManCell.DateSecondDisplayField(False) Dim DateLiteralDisplayField6 As New InputManCell.DateLiteralDisplayField("秒") ' フィールドをコレクションに追加してセルに表示書式を設定します。 GcDateTimeCell1.DisplayFields.AddRange(New InputManCell.DateDisplayField() { _ DateYearDisplayDield1, DateLiteralDisplayField1, DateMonthDisplayField1, _ DateLiteralDisplayField2, DateDayDisplayField1, DateLiteralDisplayField3, _ DateHourDisplayField1, DateLiteralDisplayField4, DateMinuteDisplayField1, _ DateLiteralDisplayField5, DateSecondDisplayField1, DateLiteralDisplayField6}) GcMultiRow1.Template = Template.CreateGridTemplate(New Cell() {GcDateTimeCell1}) GcMultiRow1.RowCount = 5
using GrapeCity.Win.MultiRow; using InputManCell = GrapeCity.Win.MultiRow.InputMan; InputManCell.GcDateTimeCell gcDateTimeCell1 = new InputManCell.GcDateTimeCell(); gcDateTimeCell1.Name = "gcDateTimeCell1"; gcDateTimeCell1.Size = new Size(180, 20); // フィールドをクリアします。 gcDateTimeCell1.Fields.Clear(); gcDateTimeCell1.DisplayFields.Clear(); // 入力フィールドのオブジェクトを作成します。 InputManCell.DateYearField dateYearField1 = new InputManCell.DateYearField(GrapeCity.Win.Editors.YearDigitType.FourDigitYear); InputManCell.DateLiteralField dateLiteralField1 = new InputManCell.DateLiteralField("/"); InputManCell.DateMonthField dateMonthField1 = new InputManCell.DateMonthField(GrapeCity.Win.Editors.MonthPattern.Number); InputManCell.DateLiteralField dateLiteralField2 = new InputManCell.DateLiteralField("/"); InputManCell.DateDayField dateDayField1 = new InputManCell.DateDayField(); InputManCell.DateLiteralField dateLiteralField3 = new InputManCell.DateLiteralField(" "); InputManCell.DateHourField dateHourField1 = new InputManCell.DateHourField(); InputManCell.DateLiteralField dateLiteralField4 = new InputManCell.DateLiteralField(":"); InputManCell.DateMinuteField dateMinuteField1 = new InputManCell.DateMinuteField(); InputManCell.DateLiteralField dateLiteralField5 = new InputManCell.DateLiteralField(":"); InputManCell.DateSecondField dateSecondField1 = new InputManCell.DateSecondField(); // フィールドをコレクションに追加してセルに入力書式を設定します。 gcDateTimeCell1.Fields.AddRange(new InputManCell.DateField[] { dateYearField1, dateLiteralField1, dateMonthField1, dateLiteralField2, dateDayField1, dateLiteralField3, dateHourField1, dateLiteralField4,dateMinuteField1, dateLiteralField5, dateSecondField1}); // 表示フィールドのオブジェクトを作成します。 InputManCell.DateYearDisplayField dateYearDisplayDield1 = new InputManCell.DateYearDisplayField(false); InputManCell.DateLiteralDisplayField dateLiteralDisplayField1 = new InputManCell.DateLiteralDisplayField("年"); InputManCell.DateMonthDisplayField dateMonthDisplayField1 = new InputManCell.DateMonthDisplayField(false); InputManCell.DateLiteralDisplayField dateLiteralDisplayField2 = new InputManCell.DateLiteralDisplayField("月"); InputManCell.DateDayDisplayField dateDayDisplayField1 = new InputManCell.DateDayDisplayField(false); InputManCell.DateLiteralDisplayField dateLiteralDisplayField3 = new InputManCell.DateLiteralDisplayField("日 "); InputManCell.DateHourDisplayField dateHourDisplayField1 = new InputManCell.DateHourDisplayField(false, false); InputManCell.DateLiteralDisplayField dateLiteralDisplayField4 = new InputManCell.DateLiteralDisplayField("時"); InputManCell.DateMinuteDisplayField dateMinuteDisplayField1 = new InputManCell.DateMinuteDisplayField(false); InputManCell.DateLiteralDisplayField dateLiteralDisplayField5 = new InputManCell.DateLiteralDisplayField("分"); InputManCell.DateSecondDisplayField dateSecondDisplayField1 = new InputManCell.DateSecondDisplayField(false); InputManCell.DateLiteralDisplayField dateLiteralDisplayField6 = new InputManCell.DateLiteralDisplayField("秒"); // フィールドをコレクションに追加してセルに表示書式を設定します。 gcDateTimeCell1.DisplayFields.AddRange(new InputManCell.DateDisplayField[] { dateYearDisplayDield1, dateLiteralDisplayField1, dateMonthDisplayField1, dateLiteralDisplayField2, dateDayDisplayField1, dateLiteralDisplayField3, dateHourDisplayField1, dateLiteralDisplayField4, dateMinuteDisplayField1, dateLiteralDisplayField5, dateSecondDisplayField1, dateLiteralDisplayField6}); gcMultiRow1.Template = Template.CreateGridTemplate(new Cell[] { gcDateTimeCell1 }); gcMultiRow1.RowCount = 5;
(図) 上記サンプルコードを適用したGcDateTimeCell
フィールドオブジェクトをDateFieldCollectionまたはDateDisplayFieldCollectionコレクションから削除するには、Removeメソッドまたは、RemoveAtメソッドを使用します。
次のサンプルコードは、DateDisplayFieldCollectionコレクションの先頭のフィールドを削除する例です。
' コレクションの先頭のオブジェクトを削除します。 Dim GcDateTimeCell As GrapeCity.Win.MultiRow.InputMan.GcDateTimeCell = DirectCast(GcMultiRow1(0, 0), GrapeCity.Win.MultiRow.InputMan.GcDateTimeCell) GcDateTimeCell.Fields.RemoveAt(0)
// コレクションの先頭のオブジェクトを削除します。
GrapeCity.Win.MultiRow.InputMan.GcDateTimeCell gcDateTimeCell = (GrapeCity.Win.MultiRow.InputMan.GcDateTimeCell)gcMultiRow1[0,0];
gcDateTimeCell.Fields.RemoveAt(0);デザイン画面での設定
デザイン画面ではフィールドオブジェクトを設定できる「入力フィールドの編集」「表示フィールドの編集」エディタから容易な設定が可能です。 このエディタは次のいずれかの方法で起動でき、日付時刻コントロールで設定可能なフィールドを組み合わせて設定します。
入力書式
- セルのスマート タグから「入力フィールドの編集...」を選択
- プロパティウィンドウのFieldsプロパティをアクティブした時に表示される「…」ボタンを押下
表示書式
- セルのスマート タグから「表示フィールドの編集...」を選択
- プロパティウィンドウのDisplayFieldsプロパティをアクティブした時に表示される「…」ボタンを押下
このエディタでは、コレクションにフィールドを追加や編集すると同時に各フィールドのテキストのフォントや色といったスタイルを設定することができます。
（図）フィールド毎に異なったスタイルを設定
入力フィールドオブジェクト
ここでは、GcDateTimeCell の入力フィールドに設定可能な11種類のフィールドについて、すべてのフィールドに共通な設定項目と各フィールドに特化した設定項目に分けて解説します。
すべてのフィールドクラスに共通な設定
これらのプロパティは、GcDateTimeCellのすべての入力フィールドオブジェクトに共通な設定項目です。
| プロパティ | 説明 |
|---|---|
| BackColor | フィールド背景色を設定します。 |
| Font | フィールドに表示される文字列のフォントを設定します。 |
| ForeColor | フィールド背景色を設定します。 |
| Margin | フィールド領域の外枠の距離を設定します。 セルの境界線からの距離や、他のフィールドとの間隔を設定する際に使用します。 |
| Padding | フィールド領域からテキストの表示エリアまでの距離を設定します。 |
リテラル文字フィールド (DateLiteralField)
リテラル文字フィールド（DateLiteralFieldクラス）は、セルに表示するリテラル文字を設定します。
| プロパティ | 説明 |
|---|---|
| Text | リテラル文字として表示する文字列を設定します。 |
年号入力フィールド (DateEraField)
年号入力フィールド (DateEraFieldクラス）は和暦表示時の年号を入力するフィールドです。
| プロパティ | 説明 |
|---|---|
| AutoDropDown | フィールドがカレットが移動されたときに自動的にドロップダウンリストを表示するかどうか指定します。 |
| DropDownEnabled | フィールドに設定可能な値をドロップダウンリストで表示できるようにするかどうか設定します。 |
| Pattern | 年号を表す文字列を設定します。 (GrapeCity.Win.Editors.EraPattern型) EraPattern.EraName のときは、年号を正式名称で表示、EraPattern.AbbreviatedEraName のときは、年号の頭文字を表示、EraPattern.Symbol のときは、年号を記号で表示します。 |
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
| SpinIncrement | スピン機能により日付を増減する値を設定します。 |
和暦入力フィールド (DateEraYearField)
和暦入力フィールド (DateEraYearFieldクラス）は、和暦年を入力するフィールドです。
| プロパティ | 説明 |
|---|---|
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
| SpinIncrement | スピン機能により日付を増減する値を設定します。 |
年入力フィールド (DateYearField)
年入力フィールド (DateYearFieldクラス）は、西暦の年を入力するフィールドです。
| プロパティ | 説明 |
|---|---|
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
| SpinIncrement | スピン機能により日付を増減する値を設定します。 |
| TwoDigitYearMax | 西暦２桁入力時の有効期間（100年間）の最後の年を取得または設定します。 |
| YearDigit | 西暦の表示桁数を設定します。 (GrapeCity.Win.Editors.YearDigitType型 YearDigitType.FourDigitYear のときは、年を４桁で表示します。YearDigitType.TwoDigitYear のときは、年を２桁で表示します。 |
月入力フィールド (DateMonthField)
月入力フィールド (DateMonthFieldクラス）は、月を入力するフィールドです。
| プロパティ | 説明 |
|---|---|
| AutoDropDown | フィールドがカレットが移動されたときに自動的にドロップダウンリストを表示するかどうか指定します。 |
| DropDownEnabled | フィールドに設定可能な値をドロップダウンリストで表示できるようにするかどうか設定します。 |
| Pattern | 月を表す文字列を設定します。 (GrapeCity.Win.Editors.MonthPattern型) MonthPattern.MonthName のときは、月を正式名称で表示します。（DateTimeFormatInfo.MonthNames()で指定された形式） MonthPattern.AbbreviatedMonthName のときは、月を月を省略形で表示します。 (DateTimeFormatInfo.AbbreviatedMonthNames() で指定された形式) MonthPattern.Number のときは、月を２桁の数字で表示（先頭に0を付ける）します。 |
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
| SpinIncrement | スピン機能により日付を増減する値を設定します。 |
日入力フィールド (DateDayField)
日入力フィールド (DateDayFieldクラス）は、日を入力するフィールドです。
| プロパティ | 説明 |
|---|---|
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
| SpinIncrement | スピン機能により日付を増減する値を設定します。 |
午前／午後入力フィールド (DateAmPmField)
午前／午後入力フィールド（DateAmPmFieldクラス）は、時刻の午前／午後を入力するフィールドです。
| プロパティ | 説明 |
|---|---|
| AMDesignator | 午前を表す文字列を設定します。 |
| Pattern | 午前／午後を表す文字の表示方法を設定します。（GrapeCity.Win.Editors.AmPmPattern型） AmPmDesignator.AmPmDesignator のときは、AMDesignatorまたはPMDesignatorで表される文字列、AmPmDesignator.AbbreviatedAmPmDesignatorで表わされる文字列の最初の１文字。 |
| PMDesignator | 午後を表す文字列を設定します。 |
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
| SpinIncrement | スピン機能により日付を増減する値を設定します。 |
12時間制時刻入力フィールド (DateShortHourField)
12時間制時刻入力フィールド (DateShortHourFieldクラス）は、12時間制の時刻を入力するフィールドです。
| プロパティ | 説明 |
|---|---|
| Hour12Mode | 12時間の範囲を定義する値を取得または設定します。(GrapeCity.Win.Editors.Hour12Mode型) Hour12Mode.Hour12As0 のときは、表示範囲を 「00:00:00 〜 11:59:59」 にします。Hour12Mode.Hour0As12 表示範囲を 「01:00:00 〜 12:59:59」 にします。 |
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
| SpinIncrement | スピン機能により日付を増減する値を設定します。 |
時入力フィールド (DateHourField)
時入力フィールド (DateHourFieldクラス）は、時刻の時を入力するフィールドです。
| プロパティ | 説明 |
|---|---|
| MidnightAs24 | 真夜中の表示方法を取得または設定します。 |
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
| SpinIncrement | スピン機能により日付を増減する値を設定します。 |
分入力フィールド (DateMinuteField)
分入力フィールド (DateMinuteFieldクラス）は、時刻の分を入力するフィールドです。
| プロパティ | 説明 |
|---|---|
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
| SpinIncrement | スピン機能により日付を増減する値を設定します。 |
秒入力フィールド (DateSecondField)
秒入力フィールド (DateSecondFieldクラス）は、時刻の秒を入力するフィールドです。
| プロパティ | 説明 |
|---|---|
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
| SpinIncrement | スピン機能により日付を増減する値を設定します。 |
表示フィールドオブジェクト
ここでは、GcDateTimeCellの表示フィールドに設定可能な14種類のフィールドについて、すべてのフィールドに共通な設定項目と各フィールドに特化した設定項目に分けて解説します。
すべてのフィールドクラスに共通な設定
これらのプロパティは、GcDateTimeCellのすべての表示フィールドオブジェクトに共通な設定項目です。
| プロパティ | 説明 |
|---|---|
| BackColor | フィールド背景色を設定します。 |
| Font | フィールドに表示される文字列のフォントを設定します。 |
| ForeColor | フィールド背景色を設定します。 |
| Margin | フィールド領域の外枠の距離を設定します。 セルの境界線からの距離や、他のフィールドとの間隔を設定する際に使用します。 |
| Padding | フィールド領域からテキストの表示エリアまでの距離を設定します。 |
リテラル文字表示フィールド (DateLiteralDisplayField)
リテラル文字表示フィールド (DateLiteralDisplayFieldクラス）は、コントロールに表示するリテラル文字を設定します。
| プロパティ | 説明 |
|---|---|
| Text | リテラル文字として表示する文字列を設定します。 |
年号表示フィールド (DateEraDisplayField)
年号表示フィールド (DateEraDisplayFieldクラス）は、和暦表示時の年号を表示するフィールドです。
| プロパティ | 説明 |
|---|---|
| Pattern | 年号を表す文字列を設定します。 (GrapeCity.Win.Editors.EraPattern型) EraPattern.EraName のときは、年号を正式名称で表示、EraPattern.AbbreviatedEraName のときは、年号の頭文字を表示、EraPattern.Symbol のときは、年号を記号で表示します。 |
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
和暦表示フィールド (DateEraYearDisplayField)
和暦表示フィールド (DateEraYearDisplayFieldクラス）は、和暦年を表示するフィールドです。
| プロパティ | 説明 |
|---|---|
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
| ShowLeadingZero | 値が1桁のとき先頭に0をつけるかどうか設定します。 |
| ShowTraditionalFirstYear | 開始年を元と表示するかどうか設定します。 |
西暦表示フィールド (DateADDisplayField)
西暦表示フィールド (DateADDisplayFieldクラス）は、紀元後を表すA.D.を表示するフィールドです。
| プロパティ | 説明 |
|---|---|
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
年表示フィールド (DateYearDisplayField)
年表示フィールド (DateYearDisplayFieldクラス）は、西暦の年を表示するフィールドです。
| プロパティ | 説明 |
|---|---|
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
| ShowLeadingZero | 値が1桁のとき先頭に0をつけるかどうか設定します。 |
| YearDigit | 西暦の表示桁数を設定します。 (GrapeCity.Win.Editors.YearDigitType型 YearDigitType.FourDigitYear のときは、年を４桁で表示します。YearDigitType.TwoDigitYear のときは、年を２桁で表示します。 |
月表示フィールド (DateMonthDisplayField)
月表示フィールド (DateMonthDisplayFieldクラス）は、月を表示するフィールドです。
| プロパティ | 説明 |
|---|---|
| Pattern | 月を表す文字列を設定します。 (GrapeCity.Win.Editors.MonthPattern型) MonthPattern.MonthName のときは、月を正式名称で表示します。（DateTimeFormatInfo.MonthNames()で指定された形式） MonthPattern.AbbreviatedMonthName のときは、月を月を省略形で表示します。 (DateTimeFormatInfo.AbbreviatedMonthNames() で指定された形式) MonthPattern.Number のときは、月を２桁の数字で表示（先頭に0を付ける）します。 |
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
| ShowLeadingZero | 値が1桁のとき先頭に0をつけるかどうか設定します。 |
日表示フィールド (DateDayDisplayField)
日表示フィールド (DateDayDisplayFieldクラス）は、日を表示するフィールドです。
| プロパティ | 説明 |
|---|---|
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
| ShowLeadingZero | 値が1桁のとき先頭に0をつけるかどうか設定します。 |
曜日表示フィールド (DateWeekdayDisplayField)
曜日表示フィールド (DateWeekdayDisplayFieldクラス）は、曜日を表示するフィールドです。
| プロパティ | 説明 |
|---|---|
| Pattern | 曜日を表す文字列を設定します。 (GrapeCity.Win.Editors.WeekdayPattern型) MonthPattern.MonthName のときは、曜日を正式名称で表示します。 (DateTimeFormatInfo.DayNames()で指定された形式) MonthPattern.AbbreviatedMonthName のときは、曜日を省略形で表示します。 (DateTimeFormatInfo.AbbreviatedDayNames()で指定された形式) |
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
午前／午後表示フィールド (DateAmPmDisplayField)
午前／午後表示フィールド (DateAmPmDisplayFieldクラス）は、時刻の午前／午後を表示するフィールドです。
| プロパティ | 説明 |
|---|---|
| AMDesignator | 午前を表す文字列を設定します。 |
| Pattern | 午前／午後を表す文字の表示方法を設定します。（GrapeCity.Win.Editors.AmPmPattern型） AmPmDesignator.AmPmDesignator のときは、AMDesignatorまたはPMDesignatorで表される文字列、AmPmDesignator.AbbreviatedAmPmDesignatorで表わされる文字列の最初の１文字。 |
| PMDesignator | 午後を表す文字列を設定します。 |
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
12時間制時刻表示フィールド (DateShortHourDisplayField)
12時間制時刻表示フィールド (DateShortHourDisplayFieldクラス）は、 12時間制の時刻を表示するフィールドです。
| プロパティ | 説明 |
|---|---|
| Hour12Mode | 12時間の範囲を定義する値を取得または設定します。(GrapeCity.Win.Editors.Hour12Mode型) Hour12Mode.Hour12As0 のときは、表示範囲を 「00:00:00 〜 11:59:59」 にします。Hour12Mode.Hour0As12 表示範囲を 「01:00:00 〜 12:59:59」 にします。 |
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
| ShowLeadingZero | 値が1桁のとき先頭に0をつけるかどうか設定します。 |
時表示フィールド (DateHourDisplayField)
時表示フィールド (DateHourDisplayFieldクラス）は、時刻の時を表示するフィールドです。
| プロパティ | 説明 |
|---|---|
| MidnightAs24 | 真夜中の表示方法を取得または設定します。 |
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
| ShowLeadingZero | 値が1桁のとき先頭に0をつけるかどうか設定します。 |
分表示フィールド (DateMinuteDisplayField)
分表示フィールド (DateMinuteDisplayFieldクラス）は、時刻の分を表示するフィールドです。
| プロパティ | 説明 |
|---|---|
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
| ShowLeadingZero | 値が1桁のとき先頭に0をつけるかどうか設定します。 |
秒表示フィールド (DateSecondDisplayField)
秒表示フィールド (DateSecondDisplayFieldクラス）は、時刻の秒を表示するフィールドです。
| プロパティ | 説明 |
|---|---|
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
| ShowLeadingZero | 値が1桁のとき先頭に0をつけるかどうか設定します。 |
システム書式表示フィールド (DateSystemFormatDisplayField)
システム書式表示フィールド (DateSystemFormatDisplayFieldクラス）は、 システムで定義された書式指定子を使用して日付または時刻の書式を設定します。
| プロパティ | 説明 |
|---|---|
| Pattern | 書式を表す書式指定子を設定します。 (String型) 下表の書式指定子を設定することができます。 |
| PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
◆ Patternプロパティに設定可能な書式指定子
| 書式指定子 | 説明 |
|---|---|
| d | 短い形式の日付 （例：2100/04/01） |
| D | 長い形式の日付 （例：2100年4月1日） |
| t | 短い形式の時刻 （例：1:30） |
| T | 長い形式の時刻 （例：1:30:00） |
| f | 長い形式の日付と短い形式の時刻 （例：2100年4月1日 1:30） |
| F | 長い形式の日付と長い形式の時刻 （例：2100年4月1日 1:30:00） |
| g | 短い形式の日付と短い形式の時刻 （例：2100/04/01 1:30） |
| G | 短い形式の日付と長い形式の時刻 （例：2100/04/01 1:30:00） |
| Mまたはm | 月日の表示 （例：4月1日） |
| Oまたはo | ラウンドトリップ形式 （例：2100-04-01T01:30:00.0000000） |
| Rまたはr | RFC1123の形式 （例：Sun, 01 Apr 2012 01:30:00 GMT） |
| s | ISO 8601準拠の形式 （例：2100-04-01T01:30:00） |
| u | ユニバーサル形式 （例：2100-04-01 01:30:00Z） |
| U | 世界協定時刻 （例：2100年3月31日 16:30:00） |
| Yまたはy | 年月の表示 （例：2100年4月） |
参照