リサイズはクリックかドラッグ

書式を設定する

このトピックでは、日付コントロールの主要機能である入力フィールドの書式設定とフィールドの活用方法について解説します。

書式の設定

日付コントロールに書式には、入力用と表示用の２つがあり、それぞれ入力フィールドと表示フィールドを使って書式を設定します。

入力フィールドを設定するには、DateFieldSetFields プロパティが参照する DateFieldCollection を使用します。DateFieldCollection は、コントロール内の各フィールドを表す DateField のコレクションを保持するクラスです。

一方、表示フィールドを設定するには、DateDisplayFieldSetDisplayFieldsプロパティが参照する DateDisplayFieldCollection を使用します。DateDisplayFieldCollection は、コントロール内の各フィールドを表す DateDisplayFieldSet のコレクションを保持するクラスです。

日付コントロールの書式を設定するには、それぞれのコレクションの Add メソッドもしくは AddRange メソッドを使用して直接フィールドオブジェクトを追加する方法と、AddRange メソッドのオーバーライドの１つを使用して、キーワード文字列によりフィールドを自動生成する方法があります。それぞれの方法による書式の設定方法については、以下のトピックを参照してください。

フィールドの操作方法

フィールドコレクション内の特定のフィールドにアクセスする場合、DateFieldSetFields プロパティあるいは DateDisplayFieldSetDisplayFields プロパティの引数としてそのフィールドのインデックス番号を指定します。

以下のサンプルコードは、インデックスを使ってフィールドを取得する例です。ここでは日付コントロールの３番目のフィールド（DateMonthField フィールド）を取得します。インデックスは０から開始することに注意してください。

コピー
using GrapeCity.Windows.InputMan.Fields;

// ３番目のフィールド（DateMonthField フィールド）を取得します。
DateMonthField myField = (DateMonthField)GcDateTime1.FieldSet.Fields[2];
イベントの利用

フィールドには、フィールド間のキャレットの移動によって発生する２つのイベントが用意されています。

  • Enter イベント （コントロール内でフィールドがアクティブになったときに発生します。）
  • Leave イベント （コントロール内でフィールドがアクティブでなくなったときに発生します。）

これらのイベントを使えば、フィールド毎に入力された値をチェックすることや、その値に応じた独自処理の実装など、フィールドを使った細やかな処理の実装を可能になります。

注意 メモ 注意

これらのイベントは、EnterEvent フィールドおよび LeaveEvent フィールドを使用して識別することができます。これらのフィールドを使うことでも、ユーザーは同様の処理を実装することが可能です。

フィールドクラスのイベントの場合、フィールド毎にイベントを実装する必要があることから、動的なフィールド操作や書式の仕様変更などに対しての処理が煩雑になる可能性があるため、フィールドクラスのイベントよりも EnterEvent フィールドおよび LeaveEvent フィールドを使うことが推奨されます。

参照