マスクコントロールでは、次の３種類のフィールドオブジェクトが用意されており、これらのオブジェクトを使って書式を設定することができます。

• MaskPatternField （パターンフィールド）
• MaskLiteralField （リテラル文字フィールド）
• MaskEnumerationField （列挙型フィールド）

これらのフィールドオブジェクトをMaskFieldCollection クラスに追加することで、マスク書式を作成します。

マスク書式は前項で解説した3つのフィールドオブジェクトを組み合わせて作成します。たとえば、郵便番号書式を作成するには、以下のフィールドオブジェクトをコレクションに追加します。

• 半角数字3文字の入力書式を定義したMaskPatternFieldオブジェクト
• ハイフン（"-"）を定義したMaskLiteralFieldオブジェクト
• 半角数字4文字の入力書式を定義したMaskPatternFieldオブジェクト

コードによる設定

オブジェクトをコレクションに追加するには、Add メソッドまたは、AddRange メソッドを使用します。

次のサンプルコードは、上記のフィールドオブジェクトをAddRange メソッドを使用してMaskFieldCollection クラスにフィールドを追加して郵便番号書式を作成しています。

Imports GrapeCity.Win.Editors.Fields

' フィールドオブジェクトを作成します。
Dim maskPatternField1 As MaskPatternField = New MaskPatternField("\D", 3, 3)
Dim maskLiteralField1 As MaskLiteralField = New MaskLiteralField("-")
Dim maskPatternField2 As MaskPatternField = New MaskPatternField("\D", 4, 4)

' フィールドをコレクションに追加してコントロールに書式を設定します。
GcMask1.Fields.AddRange(New MaskField() {maskPatternField1, maskLiteralField1, maskPatternField2})

using GrapeCity.Win.Editors.Fields;

// フィールドオブジェクトを作成します。
MaskPatternField maskPatternField1 = new MaskPatternField("\\D", 3, 3);
MaskLiteralField maskLiteralField1 = new MaskLiteralField("-");
MaskPatternField maskPatternField2 = new MaskPatternField("\\D", 4, 4);

// フィールドをコレクションに追加してコントロールに書式を設定します。
gcMask1.Fields.AddRange(new MaskField[] {maskPatternField1, maskLiteralField1, maskPatternField2});

フィールドオブジェクトをMaskFieldCollection クラスから削除するには、Remove メソッドまたは、RemoveAt メソッドを使用します。

次のサンプルコードは、MaskFieldCollection クラスの先頭のフィールドを削除する例です。

' コレクションの先頭のオブジェクトを削除します。
GcMask1.Fields.RemoveAt(0)

// コレクションの先頭のオブジェクトを削除します。
gcMask1.Fields.RemoveAt(0);

デザイン画面での設定

デザイン画面ではフィールドオブジェクトを設定できる「入力フィールドの編集」エディタから容易な設定が可能です。 このエディタは次のいずれかの方法で起動でき、マスクコントロールで設定可能な３種類のフィールドを組み合わせて設定します。

• プロパティページの「書式設定」を選択
• コントロールのスマート タグから「入力フィールドの編集...」を選択
• プロパティウィンドウのFields プロパティをアクティブにした時に表示される「…」ボタンを押下

「入力フィールドの編集」エディタ

このエディタでは、コレクションにフィールドを追加すると同時に各フィールドのテキストのフォントや色といったスタイルを設定することができます。


（図）フィールド毎に異なったスタイルを設定

ここでは、マスクコントロールに設定可能な３種類のフィールドについて、すべてのフィールドに共通な設定項目と各フィールドに特化した設定項目に分けて解説します。

すべてのフィールドクラスに共通な設定

これらのプロパティは、マスクコントロールで利用可能なすべてのフィールドオブジェクトに共通な設定項目です。

パターンフィールド (MaskPatternField)

パターンフィールド（MaskPatternField クラス）は、マスクコントロールの最も特徴的な機能である入力マスクを設定するフィールドです。
パターンフィールドで最も重要なプロパティはPattern プロパティで、入力マスクを定義するためのキーワードを設定することができます。

半角文字と全角文字は、その文字のShift-JISコードを使って識別されます。

以下にパターンフィールドでの書式設定の例をあげます。

リテラル文字フィールド (MaskLiteralField)

リテラル文字フィールド（MaskLiteralField クラス）は、コントロールに表示するリテラル文字を設定します。

列挙型フィールド (MaskEnumerationField)

列挙型フィールド（MaskEnumerationField クラス）は、設定された列挙体の項目から選択して文字列をコントロールに表示することができます。このフィールドには、列挙体で設定された文字列以外の文字は入力できません。
列挙体に設定された文字列を選択するには、コントロールのスピン機能によって順次表示させるか、列挙型フィールドにドロップダウンリストを表示してリストから選択することができます。
ドロップダウンリストはフィールド単位で表示されるため、１つのコントロールに複数の列挙体フィールドを設定すれば、複数のドロップダウンリストを持ったコントロールを作成することもできます。