MESCIUS MultiRow for Windows Forms 12.0J > InputManCellの使い方 > GcDateTimeCell > 書式の設定 > フィールドオブジェクトによる書式設定 |
ここでは、フィールドオブジェクトによる書式設定について説明します。
GcDateTimeCellには、表示にInputManのGcDate コントロールのフィールドオブジェクトのサブセットが提供されます。
入力時の書式を設定する入力フィールドには、次の11種類のフィールドが提供されており、これらのフィールドオブジェクトを使って書式を設定することができます。
表示フィールドでは、次の14種類のフィールドが提供されています。
これらのフィールドオブジェクトをDateTimeFieldCollectionまたは、DateTimeDisplayFieldCollectionコレクションに追加することで 日付時刻の書式を作成します。
GcDateTimeCellの書式は、入力および表示用の各フィールドコレクションに、前項で解説したフィールドオブジェクトを組み合わせて作成します。
入力書式を設定するには、AddまたはAddRangeメソッドを使用して、DateTimeFieldCollectionコレクションに入力用フィールドオブジェクトを追加します。表示書式は、AddまたはAddRangeメソッドを使用して、表示用フィールドオブジェクトをDateTimeDisplayFieldCollectionコレクションに追加します。
次のサンプルコードは、GcDateTimeCellに入力書式を設定する例です。
(図) 上記サンプルコードを適用したGcDateTimeCell
フィールドオブジェクトをDateFieldCollectionまたはDateDisplayFieldCollectionコレクションから削除するには、Removeメソッドまたは、RemoveAtメソッドを使用します。
次のサンプルコードは、DateDisplayFieldCollectionコレクションの先頭のフィールドを削除する例です。
デザイン画面ではフィールドオブジェクトを設定できる「入力フィールドの編集」「表示フィールドの編集」エディタから容易な設定が可能です。 このエディタは次のいずれかの方法で起動でき、日付時刻コントロールで設定可能なフィールドを組み合わせて設定します。
入力書式
表示書式
このエディタでは、コレクションにフィールドを追加や編集すると同時に各フィールドのテキストのフォントや色といったスタイルを設定することができます。
(図)フィールド毎に異なったスタイルを設定
ここでは、GcDateTimeCell の入力フィールドに設定可能な11種類のフィールドについて、すべてのフィールドに共通な設定項目と各フィールドに特化した設定項目に分けて解説します。
これらのプロパティは、GcDateTimeCellのすべての入力フィールドオブジェクトに共通な設定項目です。
プロパティ | 説明 |
---|---|
BackColor | フィールド背景色を設定します。 |
Font | フィールドに表示される文字列のフォントを設定します。 |
ForeColor | フィールド背景色を設定します。 |
Margin | フィールド領域の外枠の距離を設定します。 セルの境界線からの距離や、他のフィールドとの間隔を設定する際に使用します。 |
Padding | フィールド領域からテキストの表示エリアまでの距離を設定します。 |
リテラル文字フィールド(DateLiteralFieldクラス)は、セルに表示するリテラル文字を設定します。
プロパティ | 説明 |
---|---|
Text | リテラル文字として表示する文字列を設定します。 |
年号入力フィールド (DateEraFieldクラス)は和暦表示時の年号を入力するフィールドです。
プロパティ | 説明 |
---|---|
AutoDropDown | フィールドがカレットが移動されたときに自動的にドロップダウンリストを表示するかどうか指定します。 |
DropDownEnabled | フィールドに設定可能な値をドロップダウンリストで表示できるようにするかどうか設定します。 |
Pattern | 年号を表す文字列を設定します。 (GrapeCity.Win.Editors.EraPattern型) EraPattern.EraName のときは、年号を正式名称で表示、EraPattern.AbbreviatedEraName のときは、年号の頭文字を表示、EraPattern.Symbol のときは、年号を記号で表示します。 |
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
SpinIncrement | スピン機能により日付を増減する値を設定します。 |
和暦入力フィールド (DateEraYearFieldクラス)は、和暦年を入力するフィールドです。
プロパティ | 説明 |
---|---|
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
SpinIncrement | スピン機能により日付を増減する値を設定します。 |
年入力フィールド (DateYearFieldクラス)は、西暦の年を入力するフィールドです。
プロパティ | 説明 |
---|---|
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
SpinIncrement | スピン機能により日付を増減する値を設定します。 |
TwoDigitYearMax | 西暦2桁入力時の有効期間(100年間)の最後の年を取得または設定します。 |
YearDigit | 西暦の表示桁数を設定します。 (GrapeCity.Win.Editors.YearDigitType型 YearDigitType.FourDigitYear のときは、年を4桁で表示します。YearDigitType.TwoDigitYear のときは、年を2桁で表示します。 |
月入力フィールド (DateMonthFieldクラス)は、月を入力するフィールドです。
プロパティ | 説明 |
---|---|
AutoDropDown | フィールドがカレットが移動されたときに自動的にドロップダウンリストを表示するかどうか指定します。 |
DropDownEnabled | フィールドに設定可能な値をドロップダウンリストで表示できるようにするかどうか設定します。 |
Pattern | 月を表す文字列を設定します。 (GrapeCity.Win.Editors.MonthPattern型) MonthPattern.MonthName のときは、月を正式名称で表示します。(DateTimeFormatInfo.MonthNames()で指定された形式) MonthPattern.AbbreviatedMonthName のときは、月を月を省略形で表示します。 (DateTimeFormatInfo.AbbreviatedMonthNames() で指定された形式) MonthPattern.Number のときは、月を2桁の数字で表示(先頭に0を付ける)します。 |
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
SpinIncrement | スピン機能により日付を増減する値を設定します。 |
日入力フィールド (DateDayFieldクラス)は、日を入力するフィールドです。
プロパティ | 説明 |
---|---|
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
SpinIncrement | スピン機能により日付を増減する値を設定します。 |
午前/午後入力フィールド(DateAmPmFieldクラス)は、時刻の午前/午後を入力するフィールドです。
プロパティ | 説明 |
---|---|
AMDesignator | 午前を表す文字列を設定します。 |
Pattern | 午前/午後を表す文字の表示方法を設定します。(GrapeCity.Win.Editors.AmPmPattern型) AmPmDesignator.AmPmDesignator のときは、AMDesignatorまたはPMDesignatorで表される文字列、AmPmDesignator.AbbreviatedAmPmDesignatorで表わされる文字列の最初の1文字。 |
PMDesignator | 午後を表す文字列を設定します。 |
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
SpinIncrement | スピン機能により日付を増減する値を設定します。 |
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クラス)は、時刻の時を入力するフィールドです。
プロパティ | 説明 |
---|---|
MidnightAs24 | 真夜中の表示方法を取得または設定します。 |
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
SpinIncrement | スピン機能により日付を増減する値を設定します。 |
分入力フィールド (DateMinuteFieldクラス)は、時刻の分を入力するフィールドです。
プロパティ | 説明 |
---|---|
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
SpinIncrement | スピン機能により日付を増減する値を設定します。 |
秒入力フィールド (DateSecondFieldクラス)は、時刻の秒を入力するフィールドです。
プロパティ | 説明 |
---|---|
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
SpinIncrement | スピン機能により日付を増減する値を設定します。 |
これらのプロパティは、GcDateTimeCellのすべての表示フィールドオブジェクトに共通な設定項目です。
プロパティ | 説明 |
---|---|
BackColor | フィールド背景色を設定します。 |
Font | フィールドに表示される文字列のフォントを設定します。 |
ForeColor | フィールド背景色を設定します。 |
Margin | フィールド領域の外枠の距離を設定します。 セルの境界線からの距離や、他のフィールドとの間隔を設定する際に使用します。 |
Padding | フィールド領域からテキストの表示エリアまでの距離を設定します。 |
リテラル文字表示フィールド (DateLiteralDisplayFieldクラス)は、コントロールに表示するリテラル文字を設定します。
プロパティ | 説明 |
---|---|
Text | リテラル文字として表示する文字列を設定します。 |
年号表示フィールド (DateEraDisplayFieldクラス)は、和暦表示時の年号を表示するフィールドです。
プロパティ | 説明 |
---|---|
Pattern | 年号を表す文字列を設定します。 (GrapeCity.Win.Editors.EraPattern型) EraPattern.EraName のときは、年号を正式名称で表示、EraPattern.AbbreviatedEraName のときは、年号の頭文字を表示、EraPattern.Symbol のときは、年号を記号で表示します。 |
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
和暦表示フィールド (DateEraYearDisplayFieldクラス)は、和暦年を表示するフィールドです。
プロパティ | 説明 |
---|---|
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
ShowLeadingZero | 値が1桁のとき先頭に0をつけるかどうか設定します。 |
ShowTraditionalFirstYear | 開始年を元と表示するかどうか設定します。 |
西暦表示フィールド (DateADDisplayFieldクラス)は、紀元後を表すA.D.を表示するフィールドです。
プロパティ | 説明 |
---|---|
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
年表示フィールド (DateYearDisplayFieldクラス)は、西暦の年を表示するフィールドです。
プロパティ | 説明 |
---|---|
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
ShowLeadingZero | 値が1桁のとき先頭に0をつけるかどうか設定します。 |
YearDigit | 西暦の表示桁数を設定します。 (GrapeCity.Win.Editors.YearDigitType型 YearDigitType.FourDigitYear のときは、年を4桁で表示します。YearDigitType.TwoDigitYear のときは、年を2桁で表示します。 |
月表示フィールド (DateMonthDisplayFieldクラス)は、月を表示するフィールドです。
プロパティ | 説明 |
---|---|
Pattern | 月を表す文字列を設定します。 (GrapeCity.Win.Editors.MonthPattern型) MonthPattern.MonthName のときは、月を正式名称で表示します。(DateTimeFormatInfo.MonthNames()で指定された形式) MonthPattern.AbbreviatedMonthName のときは、月を月を省略形で表示します。 (DateTimeFormatInfo.AbbreviatedMonthNames() で指定された形式) MonthPattern.Number のときは、月を2桁の数字で表示(先頭に0を付ける)します。 |
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
ShowLeadingZero | 値が1桁のとき先頭に0をつけるかどうか設定します。 |
日表示フィールド (DateDayDisplayFieldクラス)は、日を表示するフィールドです。
プロパティ | 説明 |
---|---|
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
ShowLeadingZero | 値が1桁のとき先頭に0をつけるかどうか設定します。 |
曜日表示フィールド (DateWeekdayDisplayFieldクラス)は、曜日を表示するフィールドです。
プロパティ | 説明 |
---|---|
Pattern | 曜日を表す文字列を設定します。 (GrapeCity.Win.Editors.WeekdayPattern型) MonthPattern.MonthName のときは、曜日を正式名称で表示します。 (DateTimeFormatInfo.DayNames()で指定された形式) MonthPattern.AbbreviatedMonthName のときは、曜日を省略形で表示します。 (DateTimeFormatInfo.AbbreviatedDayNames()で指定された形式) |
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
午前/午後表示フィールド (DateAmPmDisplayFieldクラス)は、時刻の午前/午後を表示するフィールドです。
プロパティ | 説明 |
---|---|
AMDesignator | 午前を表す文字列を設定します。 |
Pattern | 午前/午後を表す文字の表示方法を設定します。(GrapeCity.Win.Editors.AmPmPattern型) AmPmDesignator.AmPmDesignator のときは、AMDesignatorまたはPMDesignatorで表される文字列、AmPmDesignator.AbbreviatedAmPmDesignatorで表わされる文字列の最初の1文字。 |
PMDesignator | 午後を表す文字列を設定します。 |
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
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クラス)は、時刻の時を表示するフィールドです。
プロパティ | 説明 |
---|---|
MidnightAs24 | 真夜中の表示方法を取得または設定します。 |
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
ShowLeadingZero | 値が1桁のとき先頭に0をつけるかどうか設定します。 |
分表示フィールド (DateMinuteDisplayFieldクラス)は、時刻の分を表示するフィールドです。
プロパティ | 説明 |
---|---|
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
ShowLeadingZero | 値が1桁のとき先頭に0をつけるかどうか設定します。 |
秒表示フィールド (DateSecondDisplayFieldクラス)は、時刻の秒を表示するフィールドです。
プロパティ | 説明 |
---|---|
PromptChar | 値が入力されていないときに表示するプロンプト文字を設定します。 |
ShowLeadingZero | 値が1桁のとき先頭に0をつけるかどうか設定します。 |
システム書式表示フィールド (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月) |