ここでは、キーワードによる書式設定について説明します。
日付コントロールでは、日付のキーワードを設定することで書式を設定することができます。 フィールドオブジェクトによる書式設定のように柔軟なスタイル設定が不要な場合、入力および表示書式についてそれぞれ1度のメソッド実行だけで定義できるため、簡単な実装が可能です。
 |
|
コードによる設定
入力書式を設定するには、Fields プロパティが参照する DateFieldCollection クラスのAddRange メソッドに、入力書式用のキーワードを使用した文字列を設定します。
表示書式を設定するには、DisplayFields プロパティが参照するDateDisplayFieldCollection クラスのAddRange メソッドに、表示書式用のキーワードを使用した文字列を設定します。
' キーワードから書式を設定します。 GcDate1.Fields.AddRange("yyyy年 MM月 dd日") GcDate1.DisplayFields.AddRange("ggg ee年 MM月 dd日")
// キーワードから書式を設定します。 gcDate1.Fields.AddRange("yyyy年 MM月 dd日"); gcDate1.DisplayFields.AddRange("ggg ee年 MM月 dd日");
なお、AddRange メソッドにより書式を設定する場合でも、自動的にフィールドオブジェクトに変換されているため、設定後に特定のフィールドスタイルを変更することが可能です。
次のサンプルコードは、キーワードにより設定した日付書式で特定のフィールドのスタイルを設定する例です。
' 入力書式フィールドのスタイルを設定します。 GcDate1.Fields(0).BackColor = Color.Bisque GcDate1.Fields(1).ForeColor = Color.DarkGray GcDate1.Fields(2).Font = New Font("Meiryo UI", 12) ' 表示書式フィールドのスタイルを設定します。 GcDate1.DisplayFields(0).Font = New Font("ＭＳ ゴシック", 15) GcDate1.DisplayFields(1).BackColor = Color.Yellow GcDate1.DisplayFields(2).ForeColor = Color.Gray
// 入力書式フィールドのスタイルを設定します。 gcDate1.Fields[0].BackColor = Color.Bisque; gcDate1.Fields[1].ForeColor = Color.DarkGray; gcDate1.Fields[2].Font = new Font("Meiryo UI", 12); // 表示書式フィールドのスタイルを設定します。 gcDate1.DisplayFields[0].Font = new Font("ＭＳ ゴシック", 15); gcDate1.DisplayFields[1].BackColor = Color.Yellow; gcDate1.DisplayFields[2].ForeColor = Color.Gray;
デザイン画面での設定
デザイン画面では「入力書式の設定」「表示書式の設定」エディタを使用して容易な設定が可能です。これらのエディタは次のいずれかの方法で起動でき、 日付のキーワードを設定することで書式を作成します。
入力書式- プロパティページの「書式設定」 - 「入力フィールド」を選択し〈キーワードによる書式設定〉ボタンを押下
- コントロールのスマート タグから「入力書式の設定...」を選択
- プロパティページの「書式設定」 - 「表示フィールド」を選択し〈キーワードによる書式設定〉ボタンを押下
- コントロールのスマート タグから「表示書式の設定...」を選択
個々のフィールドのプロパティは設定できませんが、和暦表示や「年」「月」「日」などのリテラル文字を使用した書式が予めビルトイン書式として用意されているため、これらのリストから書式を選択するだけで簡単に書式を定義することが可能です。
「表示書式の設定」エディタ |
なお、キーワードを使って設定した書式は、フィールドオブジェクトのコレクションに変換されます。フィールドオブジェクトに変換された後は「入力フィールドの編集」「表示フィールドの編集」エディタで編集できるようになります。
入力書式として使用可能なキーワードは以下のとおりです。
| キーワード | 説明 |
|---|---|
| g | 年号の頭文字をアルファベットで表示（M、T、S、H） |
| gg | 年号の頭文字を漢字で表示（明、大、昭、平） |
| ggg | 年号の正式名称を漢字で表示（明治、大正、昭和、平成） |
| e | 和暦年を２桁で表示（先頭に0を付けない） |
| ee | 和暦年を２桁で表示（先頭に0を付ける） |
| yy | 年を２桁で表示（先頭に0を付ける） |
| yyyy | 年を４桁で表示（先頭に0を付ける） |
| MM | 月を２桁の数字で表示（先頭に0を付ける） |
| MMM | 月を省略形で表示 （DateTimeFormatInfo.AbbreviatedMonthNames() で指定された形式） |
| MMMM | 月を正式名称で表示 （DateTimeFormatInfo.MonthNames() で指定された形式） |
| dd | 日を２桁で表示（先頭に0を付ける） |
| \（Chr(92)） | キーワードをリテラル文字として表示 |
表示書式として使用可能なキーワードは以下のとおりです。
| キーワード | 説明 |
|---|---|
| A | 紀元後を表す"A.D.（Anno Domini）"を表示 |
| g | 年号の頭文字をアルファベットで表示（M、T、S、H） |
| 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()で指定された形式） |
| d | 日を表示（先頭に0を付けない） |
| dd | 日を表示（先頭に0を付ける） |
| ddd | 曜日を省略形で表示（DateTimeFormatInfo.AbbreviatedDayNames()で指定された形式） |
| dddd | 曜日を正式名称で表示（DateTimeFormatInfo.DayNames()で指定された形式） |
| \（Chr(92)） | キーワードをリテラル文字として表示 |