和暦表示の設定を変更する

このトピックでは、和暦表示の設定について解説します。

和暦表示における年号のカスタマイズ

和暦表示における年号は、独自に定義することができます。独自に定義した年号の情報は、Application クラスの Resources プロパティを使用して、アプリケーションリソースとして追加します。

独自の年号定義の概要

独自の年号定義は、以下の構成要素を用いて記述します。

要素	説明
<imwpf_eras>	１つあるいは複数の <add> 要素が含まれます。
<add>	年号の名前、開始日およびショートカットを指定します。

また、<add> 要素では、以下の属性を指定する必要があります。

属性	説明
name	年号を表すキーワード "ggg" で表示される正式名称を示します。
abbreviation	年号を表すキーワード "gg" で表示される年号の頭文字を示します。
symbol	年号を表すキーワード "g" で表示される年号の頭文字をアルファベットを示します。
startDate	年号の開始日です。
shortcuts	年号をキーワードにより入力するためのショートカットを設定します。キーワードは数字、アルファベットの２つをカンマ "," で区切って指定します。

明治から令和までの年号を定義する情報は、以下のように記述します。

XAML

<imwpf_eras>
  <add name="明治" abbreviation="明" symbol="M" startDate="1868-09-08" shortcuts="1,M" />
  <add name="大正" abbreviation="大" symbol="T" startDate="1912-07-30" shortcuts="2,T" />
  <add name="昭和" abbreviation="昭" symbol="S" startDate="1926-12-25" shortcuts="3,S" />
  <add name="平成" abbreviation="平" symbol="H" startDate="1989-01-08" shortcuts="4,H" />
  <add name="令和" abbreviation="令" symbol="R" startDate="2019-05-01" shortcuts="5,R" />
</imwpf_eras>

アプリケーションリソースへの追加方法

独自の年号定義は、「imwpf_eras」というキーを持つ文字列リソースとしてアプリケーションリソースに追加します。WPF アプリケーションプロジェクトの場合は、既定で追加される App.xaml （※VB では Application.xaml ファイル）を用いてリソースを追加します。

以下のサンプルコードは、2024年10月1日以降に対して新たな年号を追加した独自の年号定義の例です。

XAML

<Application xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
       xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" 
       x:Class="WPFApplication1.App"
       xmlns:sys="clr-namespace:System;assembly=mscorlib"
       StartupUri="MainWindow.xaml">
  <Application.Resources>
    <!-- 以下の記述を追加します -->
    <!-- なお、上記のように xmlns:sys 名前空間を追加する必要があります  -->
    <sys:String x:Key="imwpf_eras">
      <![CDATA[
        <configSections>
          <section name="imwpf_eras" type="GrapeCity.Windows.InputMan.ErasSectionHandler"/>
        </configSections>
        <imwpf_eras>
          <add name="明治" abbreviation="明"  symbol="M" startDate="1868-09-08" shortcuts="1,M"/>
          <add name="大正" abbreviation="大"  symbol="T" startDate="1912-07-30" shortcuts="2,T"/>
          <add name="昭和" abbreviation="昭"  symbol="S" startDate="1926-12-25" shortcuts="3,S"/>
          <add name="平成" abbreviation="平"  symbol="H" startDate="1989-01-08" shortcuts="4,H"/>
          <add name="令和" abbreviation="令"  symbol="R" startDate="2019-05-01" shortcuts="5,R"/>
          <add name="新規" abbreviation="新"  symbol="N" startDate="2024-10-01" shortcuts="6,N"/>
        </imwpf_eras>
      ]]>
    </sys:String>
  </Application.Resources>
</Application>