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

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

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

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

コードによる設定

オブジェクトをコレクションに追加するには、Addメソッドまたは、AddRangeメソッドを使用します。
次のサンプルコードは、GcMaskCellに郵便番号書式を設定する例です。MaskFieldCollection.AddRangeメソッドを使用してMaskFieldCollectionにフィールドを追加しています。

Imports GrapeCity.Win.MultiRow
Imports InputManCell = GrapeCity.Win.MultiRow.InputMan

Dim GcMaskCell1 = New InputManCell.GcMaskCell()

' フィールドオブジェクトを作成します。 
Dim MaskPatternField1 As InputManCell.MaskPatternField = New InputManCell.MaskPatternField("\D", 3, 3)
Dim MaskLiteralField1 As InputManCell.MaskLiteralField = New InputManCell.MaskLiteralField()
Dim MaskPatternField2 As InputManCell.MaskPatternField = New InputManCell.MaskPatternField("\D", 4, 4)

MaskLiteralField1.Text = "-"

' フィールドをコレクションに追加してセルに書式を設定します。 
GcMaskCell1.Fields.AddRange(New InputManCell.MaskField() {MaskPatternField1, MaskLiteralField1, MaskPatternField2})

GcMultiRow1.Template = Template.CreateGridTemplate(New Cell() {GcMaskCell1})
GcMultiRow1.RowCount = 5
                                                                

using GrapeCity.Win.MultiRow;
using InputManCell = GrapeCity.Win.MultiRow.InputMan;

InputManCell.GcMaskCell gcMaskCell1 = new InputManCell.GcMaskCell();

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

maskLiteralField1.Text = "-";

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

gcMultiRow1.Template = Template.CreateGridTemplate(new Cell[] { gcMaskCell1 });
gcMultiRow1.RowCount = 5;
                            

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

セルの設定を変更した場合、変更を反映させるためにテンプレートをMultiRowに割り当てなおす必要があります。

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

' コレクションの先頭のオブジェクトを削除します。
Dim GcMaskCell As GrapeCity.Win.MultiRow.InputMan.GcMaskCell = DirectCast(GcMultiRow1(0, 0), GrapeCity.Win.MultiRow.InputMan.GcMaskCell)
GcMaskCell.Fields.RemoveAt(0)
                                                                

// コレクションの先頭のオブジェクトを削除します。
GrapeCity.Win.MultiRow.InputMan.GcMaskCell gcMaskCell = (GrapeCity.Win.MultiRow.InputMan.GcMaskCell)gcMultiRow1[0, 0];
gcMaskCell.Fields.RemoveAt(0);
                                                                

デザイン画面での設定

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

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

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

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

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

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

◆ Pattern プロパティで使用可能な表現のタイプ

◆ Pattern プロパティで使用可能なキーワード

1. 主要なキーワード

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

2. 補助的なキーワード      

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

列挙型フィールド (MaskEnumerationField)

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