| PowerTools CalendarGrid for Windows Forms 1.0J > CalendarGridの使い方 > 暦のカスタマイズ > 祝日定義ファイルのインポート |
CalendarGridで表示される祝日の設定は、定義ファイルに保存して利用することができます。
祝日定義ファイルは、休日と休日スタイルが定義されたXMLファイルです。CalendarGridのカレンダーで、この定義ファイルをインポートすることで、コーディングや、プロパティの設定なしに簡単に祝日を設定することができます。
なお、CalendarGridには、サンプルとして国民の祝日が予め登録された休日定義ファイルが付属しています。サンプルの祝日定義ファイルは、CalendarGridの製品サンプルのSamples.zipに含まれる「Holiday.xml」です。また、サンプルの祝日定義ファイルには、次の注意点があります。
春分の日と秋分の日について
定義ファイルに登録されている春分の日と秋分の日は１９５０年から２０９９年まで登録されています。また、これらの日付は天文学に基づく計算から算出されていますが、実際の祝日とは異なる可能性があります。春分の日と秋分の日は、毎年２月に翌年分が閣議決定され、官報によって公布されます。
ハッピーマンデーについて
成人の日、海の日、敬老の日、体育の日は、祝日改正法に基づいた日付で登録されています。よって、法律改正前の暦については、成人の日、海の日、敬老の日、体育の日が異なります。
山の日について
定義ファイルに登録されている山の日は２０１６年から２０９９年まで登録されています。
ファイルへのインポートは、CalendarHolidayCollectionクラスのLoadXmlメソッドを使ってコードから実行することができます。
次のコードは、休日定義ファイルをインポートする例です。
' 2000年1月1日から2030年12月31日までの休日をインポートします。 GcCalendarGrid1.Holidays.LoadXml("ファイル名", New DateTime(2000, 1, 1), New DateTime(2030, 12, 31))
// 2000年1月1日から2030年12月31日までの休日をインポートします。 gcCalendarGrid1.Holidays.LoadXml("ファイル名", new DateTime(2000, 1, 1), new DateTime(2030, 12, 31));