キーワードによる書式設定(GcNumber型セル)

GcNumber型セルでは、数値のキーワードを設定することで書式を設定することができます。フィールドオブジェクトによる書式設定のように柔軟なスタイル設定が不要な場合、入力および表示書式についてそれぞれ1度のメソッド実行だけで定義できるため、簡単な実装が可能です。

入力書式を設定するには、Fields プロパティが参照するNumberFieldsInfo クラスのSetFields メソッドに、入力書式用のキーワードを使用した文字列を設定します。
表示書式を設定するには、DisplayFields プロパティが参照するNumberDisplayFieldCollectionInfo クラスのAddRange メソッドに、表示書式用のキーワードを使用した文字列を設定します。

キーワードは文字列として次の順番で定義します。

Pattern, positive prefix, positive suffix, negative prefix, negattive suffix

サンプルコード

次のサンプルコードは、キーワードで書式を設定します。

C#	コードのコピー
GrapeCity.Win.Spread.InputMan.CellType.GcNumberCellType gcNumberCell1 = new GrapeCity.Win.Spread.InputMan.CellType.GcNumberCellType(); // キーワードから書式を設定 gcNumberCell1.Fields.SetFields("####0.00,,,-,"); gcNumberCell1.DisplayFields.AddRange("####0.00,,,-,"); fpSpread1.ActiveSheet.Cells[0, 0].CellType = gcNumberCell1;

コードのコピー

GrapeCity.Win.Spread.InputMan.CellType.GcNumberCellType gcNumberCell1 = new GrapeCity.Win.Spread.InputMan.CellType.GcNumberCellType();
// キーワードから書式を設定
gcNumberCell1.Fields.SetFields("####0.00,,,-,");
gcNumberCell1.DisplayFields.AddRange("####0.00,,,-,");
fpSpread1.ActiveSheet.Cells[0, 0].CellType = gcNumberCell1;

Visual Basic	コードのコピー
Dim gcNumberCell1 As New GrapeCity.Win.Spread.InputMan.CellType.GcNumberCellType() ' キーワードから書式を設定 gcNumberCell1.Fields.SetFields("####0.00,,,-,") gcNumberCell1.DisplayFields.AddRange("####0.00,,,-,") FpSpread1.ActiveSheet.Cells(0, 0).CellType = gcNumberCell1

Visual Basic

コードのコピー

Dim gcNumberCell1 As New GrapeCity.Win.Spread.InputMan.CellType.GcNumberCellType()
' キーワードから書式を設定
gcNumberCell1.Fields.SetFields("####0.00,,,-,")
gcNumberCell1.DisplayFields.AddRange("####0.00,,,-,")
FpSpread1.ActiveSheet.Cells(0, 0).CellType = gcNumberCell1

入力書式のキーワード

入力書式として使用可能なキーワードは以下のとおりです。

キーワード	説明
#	数値の桁を指定します。値が0の場合は何も表示されません。
0	数値の桁を指定します。値が0の場合は0を表示します。
.（ピリオド）	小数点の挿入位置を指定します。キーワード内に含められるのは１つだけです。
,（カンマ）	カンマの挿入位置を指定します。少数部に指定することはできません。

表示書式のキーワード

表示書式として使用可能なキーワードは以下のとおりです。

キーワード	説明
#	数値の桁を指定します。値が0の場合は何も表示されません。
0	数値の桁を指定します。値が0の場合は0を表示します。
.（ピリオド）	小数点の挿入位置を指定します。キーワード内に含められるのは１つだけです。
,（カンマ）	カンマの挿入位置を指定します。少数部に指定することはできません。
[DBNum1]G	数値を漢数字で表示します。（例：一億二千三百四十五万六千七百八十九）
[DBNum2]G	数字を漢数字（大字）で表示します。（例：壱億弐阡参百四拾伍萬六阡七百八拾九）
[DBNum3]G	数字を漢数字と全角の数字を組み合わせて表示します。（例：１億２千３百４十５万６千７百８十９）
[DBNum4]G	小数点以下の数字を漢数字を使って表示します。（例：〇.九分八厘七毛六糸五忽四微三纖二沙一塵）
[:]	[###:千]のように使用します。コロンの前に記載した桁数をコロンの後に記載した文字列に置き換えます。（例：1,234千円）