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

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

これらのフィールドオブジェクトを MaskFieldCollection に追加するには、Add メソッドまたは、AddRange メソッドを使用します。

以下のサンプルコードは、マスクコントロールに郵便番号書式を設定する例です。AddRange メソッドを使用して MaskFieldCollection にフィールドを追加しています。

Imports GrapeCity.Windows.InputMan.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.FieldSet.Fields.AddRange(New MaskField() {maskPatternField1, maskLiteralField1, maskPatternField2})

using GrapeCity.Windows.InputMan.Fields;

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

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

<im:GcMask>
  <im:GcMask.FieldSet>
    <im:MaskFieldSet>
      <im:MaskPatternField MaxLength="3" MinLength="3" Pattern="\D" />
      <im:MaskLiteralField Text="-" />
      <im:MaskPatternField MaxLength="4" MinLength="4" Pattern="\D" />
    </im:MaskFieldSet>
  </im:GcMask.FieldSet>
</im:GcMask>

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

以下のサンプルコードは、MaskFieldCollection の先頭のフィールドを削除する例です。

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

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

Pattern プロパティで使用可能な表現のタイプは以下の通りです。

Pattern プロパティで使用可能なキーワードは以下の通りです。

1. 主要なキーワード

   半角	全角	説明
   \A	\Ａ	大文字のアルファベットを表します。[A-Z]または[Ａ-Ｚ]と同等です。
   \a	\ａ	小文字のアルファベットを表します。[a-z]または[ａ-ｚ]と同等です。
   \D	\Ｄ	数字を表します。[0-9]または[０-９]と同等です。
   \B	\Ｂ	２進数を表します。[0-1]または[０-１]と同等です。
   \X	\Ｘ	16 進数を表します。[0-9A-Fa-f]または[０-９Ａ-Ｆａ-ｆ]と同等です。
   \W	\Ｗ	すべての英数字を表します。[a-zA-Z_0-9]または[ａ-ｚＡ-Ｚ＿０-９]と同等です。
   \K	\Ｋ	カタカナ（促音・拗音の小書き表記あり）を表します。
   \N	\Ｎ	カタカナ（促音・拗音の小書き表記なし）を表します。
   \H	-	すべての半角文字を表します。
   -	\Ｊ	ひらがな（促音・拗音の小書き表記あり）を表します。
   -	\Ｇ	ひらがな（促音・拗音の小書き表記なし）を表します。
   -	\Ｚ	すべての全角文字を表します。
   -	\Ｔ	サロゲート ペア文字を表します。

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

2. 補助的なキーワード

   メタ文字	説明
   ^	その後に続く文字グループの補集合をあらわします。
   -	文字の範囲を指定します。
   \（Chr(92)）	キーワードをリテラル文字として表示

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

リテラルフィールド（MaskLiteralField）

リテラルフィールド（MaskLiteralField）は、コントロールに表示するリテラル文字を設定します。リテラルフィールド固有のプロパティは以下の Text プロパティのみです。

列挙型フィールド（MaskEnumerationField）

列挙型フィールド（MaskEnumerationField）は、設定された列挙値の項目から選択して文字列をコントロールに表示することができます。このフィールドには、列挙値で設定された文字列以外の文字は入力できません。

列挙値に設定された文字列を選択するには、コントロールのスピン機能によって順次表示させるか、列挙型フィールドにドロップダウンリストを表示してリストから選択することができます。

ドロップダウンリストはフィールド単位で表示されるため、１つのコントロールに複数の列挙型フィールドを設定すれば、複数のドロップダウンリストを持ったコントロールを作成することもできます。