ヘッダの書式設定

ドロップダウンカレンダーのヘッダに表示できる書式の設定について解説します。

月-日カレンダーの書式設定

CalendarTypeプロパティがCalendarType.MonthDayのとき（月-日カレンダー）のヘッダの表示書式はHeaderFormatプロパティで設定します。HeaderFormatプロパティに以下のキーワードとリテラル文字を設定することで、書式を作成します。

キーワード	説明
g	年号の頭文字をアルファベットで表示（M、T、S、H、R）
gg	年号の頭文字を漢字で表示（明、大、昭、平、令）
ggg	年号の正式名称を漢字で表示（明治、大正、昭和、平成、令和）
e	和暦年を２桁で表示（先頭に0を付けない）
ee	和暦年を２桁で表示（先頭に0を付ける）
E	和暦年を２桁で表示し開始年を元と表示（先頭に0を付けない）（例：平成元年）
EE	和暦年を２桁で表示し開始年を元と表示（先頭に0を付ける）（例：平成元年）
y	年を２桁で表示（先頭に0を付けない）
yy	年を２桁で表示（先頭に0を付ける）
yyy	年を４桁で表示（先頭に0を付けない）
yyyy	年を４桁で表示（先頭に0を付ける）
M	月を２桁の数字で表示（先頭に0を付けない）
MM	月を２桁の数字で表示（先頭に0を付ける）
MMM	月を省略形で表示（DateTimeFormatInfo.AbbreviatedMonthNames() で指定された形式）
MMMM	月を正式名称で表示（DateTimeFormatInfo.MonthNames()で指定された形式）
\（Chr(92)）	キーワードをリテラル文字として表示

キーワード"e"、"ee"、"E"、または"EE"を使用する場合は、元号を表すキーワード"g"、"gg"、または"ggg"を必ず併用してください。
和暦表示が可能な日付の範囲は、1868年9月1日～2087年12月31日です。この範囲を超えた場合は、西暦で表示されます。

次のサンプルコードはヘッダの書式を設定する例です。

Visual Basic
C#

Imports GrapeCity.Win.MultiRow
Imports InputManCell = GrapeCity.Win.MultiRow.InputMan

Dim GcDateTimeCell1 As New InputManCell.GcDateTimeCell()

GcDateTimeCell1.DropDownCalendar.ShowHeader = True
GcDateTimeCell1.DropDownCalendar.HeaderHeight = 25
GcDateTimeCell1.DropDownCalendar.UseHeaderFormat = True
GcDateTimeCell1.DropDownCalendar.HeaderFormat = "ggg e年 M月"

GcMultiRow1.Template = Template.CreateGridTemplate(New Cell() {GcDateTimeCell1})

using GrapeCity.Win.MultiRow;
using InputManCell = GrapeCity.Win.MultiRow.InputMan;

InputManCell.GcDateTimeCell gcDateTimeCell1 = new InputManCell.GcDateTimeCell();

gcDateTimeCell1.DropDownCalendar.ShowHeader = true;
gcDateTimeCell1.DropDownCalendar.HeaderHeight = 25;
gcDateTimeCell1.DropDownCalendar.UseHeaderFormat = true;
gcDateTimeCell1.DropDownCalendar.HeaderFormat = "ggg e年 M月";

gcMultiRow1.Template = Template.CreateGridTemplate(new Cell[] { gcDateTimeCell1 });
gcMultiRow1.RowCount = 5;

年-月カレンダーの書式設定

CalendarTypeプロパティがCalendarType.YearMonth（年-月カレンダー）のときの書式設定には、YearMonthFormatプロパティが参照するYearMonthFormatオブジェクトを使用します。

YearMonthFormatオブジェクトのMonthFormatおよびYearFormatプロパティにキーワードとリテラル文字を設定することで、月の書式、年の書式をそれぞれ作成します。

月の設定に関するキーワード

キーワード	説明
M	月を２桁の数字で表示（先頭に0を付けない）
MM	月を２桁の数字で表示（先頭に0を付ける）
MMM	月を省略形で表示（DateTimeFormatInfo.AbbreviatedMonthNames() で指定された形式）
MMMM	月を正式名称で表示（DateTimeFormatInfo.MonthNames()で指定された形式）

年の設定に関するキーワード

キーワード	説明
g	年号の頭文字をアルファベットで表示（M、T、S、H、R）
gg	年号の頭文字を漢字で表示（明、大、昭、平、令）
ggg	年号の正式名称を漢字で表示（明治、大正、昭和、平成、令和）
e	和暦年を２桁で表示（先頭に0を付けない）
ee	和暦年を２桁で表示（先頭に0を付ける）
E	和暦年を２桁で表示し開始年を元と表示（先頭に0を付けない）（例：平成元年）
EE	和暦年を２桁で表示し開始年を元と表示（先頭に0を付ける）（例：平成元年）
y	年を２桁で表示（先頭に0を付けない）
yy	年を２桁で表示（先頭に0を付ける）
yyy	年を４桁で表示（先頭に0を付けない）
yyyy	年を４桁で表示（先頭に0を付ける）

キーワード"e"、"ee"、"E"、または"EE"を使用する場合は、元号を表すキーワード"g"、"gg"、または"ggg"を必ず併用してください。
和暦表示が可能な日付の範囲は、1868年9月1日～2087年12月31日です。この範囲を超えた場合は、西暦で表示されます。

次のサンプルコードは、年-月カレンダーの表示書式を設定する方法を示します。

Visual Basic
C#

Imports GrapeCity.Win.MultiRow
Imports InputManCell = GrapeCity.Win.MultiRow.InputMan

Dim GcDateTimeCell1 As New InputManCell.GcDateTimeCell()

GcDateTimeCell1.DropDownCalendar.ShowHeader = True
GcDateTimeCell1.DropDownCalendar.CalendarType = GrapeCity.Win.Editors.CalendarType.YearMonth
GcDateTimeCell1.DropDownCalendar.YearMonthFormat.YearFormat = "ggg e年"
GcDateTimeCell1.DropDownCalendar.YearMonthFormat.MonthFormat = "MM月"

GcMultiRow1.Template = Template.CreateGridTemplate(New Cell() {GcDateTimeCell1})

using GrapeCity.Win.MultiRow;
using InputManCell = GrapeCity.Win.MultiRow.InputMan;

InputManCell.GcDateTimeCell gcDateTimeCell1 = new InputManCell.GcDateTimeCell();

gcDateTimeCell1.DropDownCalendar.CalendarType = GrapeCity.Win.Editors.CalendarType.YearMonth;
gcDateTimeCell1.DropDownCalendar.YearMonthFormat.YearFormat = "ggg e年";
gcDateTimeCell1.DropDownCalendar.UseHeaderFormat = true;
gcDateTimeCell1.DropDownCalendar.YearMonthFormat.MonthFormat = "MM月"; 

gcMultiRow1.Template = Template.CreateGridTemplate(new Cell[] { gcDateTimeCell1 });
gcMultiRow1.RowCount = 5;