マスク型セルの書式は、入力マスクによりユーザーが入力可能なデータの形式を制限する機能です。書式設定にはキーワードを使用する方法と、フィールド オブジェクトを使用する方法があります。それぞれの方法について説明します。

キーワードによる書式設定

FieldSet プロパティに書式を表す MaskFieldSet を設定します。MaskFieldSet クラスのコンストラクタでキーワードを使用して書式を設定します。使用できるキーワードは次のとおりです。なお、半角文字と全角文字は文字の Shift-JIS コードを使用して識別します。

文字種のキーワード

その他のキーワード

以下、キーワードの設定例です。

キーワードによる書式設定について、次のサンプルコードを参照してください。

次のサンプルコードはマスク型セルに郵便番号の書式をキーワードで設定します。

MaskCellType msk = new MaskCellType();
msk.FieldSet = new MaskFieldSet(@"〒\D{3}-\D{4}");
gcSpreadGrid1[0, 0].CellType = msk;

Dim msk As New MaskCellType()
msk.FieldSet = New MaskFieldSet("〒\D{3}-\D{4}")
GcSpreadGrid1(0, 0).CellType = msk

フィールド オブジェクトによる書式設定

FieldSet プロパティで書式を表す MaskFieldSet を取得し Fields プロパティでフィールド オブジェクトのコレクションを参照します。フィールド オブジェクトを追加するにはコレクションの Add メソッドを使用します。書式で使用できるフィールドクラスは次のとおりです。これらのクラスを使用してフィールド オブジェクトを作成します。

リテラル文字フィールド以外は、上の表の設定に加えて PromptChar プロパティで未入力のときに表示するプロンプト文字を設定できます。

フィールド オブジェクトによる書式設定について、次のサンプルコードを参照してください。

次のサンプルコードはマスク型セルに郵便番号の書式をフィールド オブジェクトで設定します。

MaskCellType msk = new MaskCellType();
msk.FieldSet = new MaskFieldSet();
msk.FieldSet.Fields.Add(new MaskLiteralField() { Text = "〒" });
msk.FieldSet.Fields.Add(new MaskPatternField() { Pattern=@"\D", MinLength=3, MaxLength=3});
msk.FieldSet.Fields.Add(new MaskLiteralField() { Text = "-" });
msk.FieldSet.Fields.Add(new MaskPatternField() { Pattern = @"\D", MinLength = 4, MaxLength = 4 });
gcSpreadGrid1[0, 0].CellType = msk;

Dim msk As New MaskCellType()
msk.FieldSet = New MaskFieldSet()
msk.FieldSet.Fields.Add(New MaskLiteralField() With {.Text = "〒"})
msk.FieldSet.Fields.Add(New MaskPatternField() With {.Pattern = "\D", .MinLength = 3, .MaxLength = 3})
msk.FieldSet.Fields.Add(New MaskLiteralField() With {.Text = "-"})
msk.FieldSet.Fields.Add(New MaskPatternField() With {.Pattern = "\D", .MinLength = 4, .MaxLength = 4})
GcSpreadGrid1(0, 0).CellType = msk