 |
参考：和暦とは？ 和暦（われき）は、西暦に対する日本の年号（元号、邦暦とも）を示します。とくに公文書で用いられますが、これに限りません。また、官公庁であっても国際比較やパスポートなど、西暦（和暦併記）が用いられる場合もあります。 |
CalendarGridではInputMan互換の日付書式によって和暦を表示できます。
和暦を独自に定義するには、アプリケーション構成ファイルを使用します。この方法は、InputMan for Windows Formsと共通です。
アプリケーション構成ファイル
アプリケーション構成ファイルにより独自に定義することもできます。また、定義した構成ファイルは、アプリケーションに含めて配布することができます。さらに、エンドユーザーもこの構成ファイルを変更することが可能で、アプリケーションを配布した後でも自由に設定を変更することができます。
構成ファイルの詳細については、MSDNの「
構成ファイルを使用してアプリを構成する方法」を参照してください。
構成ファイルの作成
アプリケーション構成ファイルは、配布するアプリケーションと同じフォルダに配置されます。構成ファイルは、アプリケーション名に拡張子 .config を付けた名前になります。たとえば、myApp.exe という名前のアプリケーションがある場合、構成ファイルは myApp.exe.config という名前になります。
構成ファイルは以下の手順で作成することができます。
- Visual Studioを起動し、対象となるプロジェクトを開きます。
- [ファイル]メニューまたは[プロジェクト]メニューから[新しい項目の追加]を選択します。
- [新しい項目の追加]ダイアログが表示されるので、その[テンプレート:]から「アプリケーション構成ファイル」を選択し〈OK〉ボタンをクリックします。
年号を設定する構成ファイルは、構成セクションスキーマで構成されます。構成セクションスキーマの詳細についてはMSDNの「構成セクションスキーマ」を参照してください。
アプリケーション構成ファイルに以下の要素が記述されない場合、コントロールに表示される年号は既定の値が表示されます。
| 要素 | 説明 |
|---|---|
|
<configuration> |
アプリケーションで使用されるすべての構成ファイルのルート要素です。 |
|
<configSections> |
構成セクションと名前空間の宣言を指定します。 |
|
<section> |
構成セクションの宣言を指定します。 |
|
<GrapeCityEra> |
<add>要素が含まれています。 |
|
<add> |
年号の名前、開始日およびショートカットを指定します。 |
以下に、2019年5月1日以降に対して新たな年号を追加した設定例を示します。
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configSections>
<section name="GrapeCityEra" type="System.Configuration.NameValueSectionHandler"/>
</configSections>
<GrapeCityEra>
<add key="1868 09 08" value="明治_明_M_1,M"/>
<add key="1912 07 30" value="大正_大_T_2,T"/>
<add key="1926 12 25" value="昭和_昭_S_3,S"/>
<add key="1989 01 08" value="平成_平_H_4,H"/>
<add key="2019 05 01" value="令和_令_R_5,R"/>
</GrapeCityEra>
</configuration>
|
注意:
|
add要素
年号の開始日、名前、およびショートカットを指定します。
| 属性 | 説明 |
|---|---|
|
key |
年号の開始日を指定します。yyyy MM ddの形式で、年月日の間は半角スペース" "で区切ります。 |
|
value |
以下の順序で名前やショートカットを指定します。間はアンダーバー"_"で区切ります。 年号を表すキーワード "ggg"で表示される、正式名称 |