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

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

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

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

• 半角数字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)

' フィールドをコレクションに追加してコントロールに書式を設定します。
GcMaskedComboBox1.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);

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

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

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

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

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

デザイン画面での設定

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

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

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

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


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

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

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

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

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

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

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

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

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

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