数値型セルは、入力用および表示用の書式をそれぞれ設定できます。入力書式はセルが編集状態のときに適用され、表示書式はセルが非編集状態のときに適用されます。数値型セルの入力書式は、書式に合わないデータが入力されないようにユーザーの入力を制限します。

（左）入力書式の例        （右）表示書式の例

書式設定にはキーワードを使用する方法と、フィールド オブジェクトを使用する方法があります。入力および表示書式の設定方法について、それぞれ説明します。

入力書式

キーワードによる入力書式の設定

FieldSet プロパティに入力書式を表す NumberFieldSet を設定します。NumberFieldSet クラスのコンストラクタでキーワードを使用して書式を設定します。なお、書式設定には次の構文を使用します。

構文

パターン文字列,正の数の接頭辞,正の数の接尾辞,負の数の接頭辞,負の数の接尾辞

例

#,##0,,,-,

使用できるキーワードは次のとおりです。

次のサンプルコードは数値型セルの入力書式をキーワードで設定します。

NumberCellType num = new NumberCellType();
num.FieldSet = new NumberFieldSet("#,##0,,,-,");
gcSpreadGrid1[0, 0].CellType = num;

Dim num As New NumberCellType()
num.FieldSet = New NumberFieldSet("#,##0,,,-,")
GcSpreadGrid1(0, 0).CellType = num

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

FieldSet プロパティで入力書式を表す NumberFieldSet を取得し NumberFieldSet クラスのプロパティでフィールドオブジェクトを参照します。NumberFieldSet にはあらかじめ、接頭辞、整数部分、小数点、小数部分、接尾辞を表すフィールドオブジェクトが作成されています。開発者が新たにフィールドを追加または削除する必要はありません。NumberFieldSet の各プロパティで参照できるフィールドオブジェクトは次のとおりです。

次のサンプルコードは数値型セルの入力書式をフィールド オブジェクトで設定します。

NumberCellType num = new NumberCellType();
num.FieldSet.SignPrefix.NegativePattern = "-" ;
num.FieldSet.IntegerPart.GroupSizes.Add(new IntegerItem(3));
num.FieldSet.IntegerPart.MinDigits = 1;
gcSpreadGrid1[0, 0].CellType = num;

Dim num As New NumberCellType()
num.FieldSet.SignPrefix.NegativePattern = "-"
num.FieldSet.IntegerPart.GroupSizes.Add(New IntegerItem(3))
num.FieldSet.IntegerPart.MinDigits = 1
GcSpreadGrid1(0, 0).CellType = num

表示書式

キーワードによる表示書式の設定

DisplayFieldSet プロパティに表示書式を表す NumberDisplayFieldSet を設定します。NumberDisplayFieldSet クラスのコンストラクタでキーワードを使用して書式を設定します。なお、書式設定には入力書式と同様に次の構文を使用します。

構文

パターン文字列,正の数の接頭辞,正の数の接尾辞,負の数の接頭辞,負の数の接尾辞

例

[###:千円],,,▲,

使用できるキーワードは次のとおりです。

次のサンプルコードは数値型セルの表示書式をキーワードで設定します。

NumberCellType num = new NumberCellType();
num.DisplayFieldSet = new NumberDisplayFieldSet("[###:千円],,,▲,");
gcSpreadGrid1[0, 0].CellType = num;

Dim num As New NumberCellType()
num.DisplayFieldSet = New NumberFieldSet("[###:千円],,,▲,")
GcSpreadGrid1(0, 0).CellType = num

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

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

次のサンプルコードは数値型セルの表示書式をフィールド オブジェクトで設定します。

NumberCellType num = new NumberCellType();
num.DisplayFieldSet = new NumberDisplayFieldSet();
num.DisplayFieldSet.DisplayFields.Add(new NumberSignDisplayField() { NegativePattern="▲"});
num.DisplayFieldSet.DisplayFields.Add(new NumberMoneyPatternDisplayField(){Pattern="[###:千円]"});
gcSpreadGrid1[0, 0].CellType = num; 

Dim num As New NumberCellType()
num.DisplayFieldSet = New NumberDisplayFieldSet()
num.DisplayFieldSet.DisplayFields.Add(New NumberSignDisplayField() With {.NegativePattern = "▲"})
num.DisplayFieldSet.DisplayFields.Add(New NumberMoneyPatternDisplayField() With {.Pattern = "[###:千円]"})
GcSpreadGrid1(0, 0).CellType = num