入力時の書式を設定する入力フィールドには、次の4種類のフィールドが提供されており、これらのフィールドオブジェクトを使って書式を設定することができます。

• NumberSignField （接頭語／接尾語のフィールド）
• NumberIntegerPartField （整数入力フィールド）
• NumberDecimalSeparatorField （小数点フィールド）
• NumberDecimalPartField （小数入力フィールド）

また、表示フィールドでは、次の8種類のフィールドが提供されています。

• NumberLiteralDisplayField （リテラル文字表示フィールド）
• NumberSignDisplayField （接頭語／接尾語の表示フィールド）
• NumberIntegerPartDisplayField （整数表示フィールド）
• NumberDecimalSeparatorDisplayField （小数点フィールド）
• NumberDecimalPartDisplayField （小数表示フィールド）
• NumberDecimalGeneralFormatDisplayField （漢数字の表示フィールド）
• NumberMoneyPatternDisplayField （下の桁をリテラル文字に置き換えるフィールド）
• NumberSystemFormatDisplayField （システム表示書式フィールド）

フィールドオブジェクトをNumberDisplayFieldCollection コレクションに追加することで 数値の表示書式を作成します。 また、NumberFieldCollection クラスに追加されている各入力フィールドを設定することでフィールドのスタイルを変更することができます。

数値の入力書式を設定するNumberFields コレクションではコレクションのアイテムを追加または削除できません。表示書式は、表示用のNumberDisplayFieldCollection コレクションに、前項で解説したフィールドオブジェクトを組み合わせて作成します。

コードによる設定

表示書式を設定するNumberDisplayFieldCollection コレクションにフィールドオブジェクトを追加するには、Add メソッドまたは、AddRange メソッドを使用します。

次のサンプルコードは、数値コントロールに表示書式を設定する例です。

Imports GrapeCity.Win.Editors.Fields

' フィールドをクリアします。
GcNumber1.DisplayFields.Clear()

' 表示フィールドのオブジェクトを作成します。
Dim NumberSignDisplayField1 As New NumberSignDisplayField("\\", "\\-")
Dim NumberIntegerPartDisplayField1 As New NumberIntegerPartDisplayField()
Dim NumberDecimalSeparatorDisplayField1 As New NumberDecimalSeparatorDisplayField()
Dim NumberDecimalPartDisplayField1 As New NumberDecimalPartDisplayField()
Dim NumberSignDisplayField2 As New NumberSignDisplayField("（税込）", "（税込）")

' フィールドをコレクションに追加してコントロールに表示書式を設定します。
GcNumber1.DisplayFields.AddRange(New NumberDisplayField() { _
    NumberSignDisplayField1, NumberIntegerPartDisplayField1, _
    NumberDecimalSeparatorDisplayField1, NumberDecimalPartDisplayField1, _
    NumberSignDisplayField2 _
})

using GrapeCity.Win.Editors.Fields;

// フィールドをクリアします。
gcNumber1.DisplayFields.Clear();

// 表示フィールドのオブジェクトを作成します。
NumberSignDisplayField numberSignDisplayField1 = new NumberSignDisplayField("\\", "\\-");
NumberIntegerPartDisplayField numberIntegerPartDisplayField1 = new NumberIntegerPartDisplayField();
NumberDecimalSeparatorDisplayField numberDecimalSeparatorDisplayField1 = new NumberDecimalSeparatorDisplayField();
NumberDecimalPartDisplayField numberDecimalPartDisplayField1 = new NumberDecimalPartDisplayField();
NumberSignDisplayField numberSignDisplayField2 = new NumberSignDisplayField("（税込）", "（税込）");

// フィールドをコレクションに追加してコントロールに表示書式を設定します。
gcNumber1.DisplayFields.AddRange(new NumberDisplayField[] {
    numberSignDisplayField1, numberIntegerPartDisplayField1,  
    numberDecimalSeparatorDisplayField1, numberDecimalPartDisplayField1,
     numberSignDisplayField2
});

　　　
(図) 上記サンプルコードを適用したコントロール

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

次のサンプルコードは、NumberDisplayFieldCollection コレクションの先頭のフィールドを削除する例です。

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

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

デザイン画面での設定

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

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

• プロパティページの「書式設定」-「表示フィールド」を選択
• コントロールのスマート タグから「表示フィールドの編集...」を選択
• プロパティウィンドウのDisplayFields プロパティをアクティブした時に表示される「…」ボタンを押下

「入力フィールドの編集」エディタ

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

ここでは、数値コントロールの入力フィールドに設定可能な4種類のフィールドについて、すべてのフィールドに共通な設定項目と各フィールドに特化した設定項目にわけて解説します。

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

これらのプロパティは、数値コントロールのすべての入力フィールドオブジェクトに共通な設定項目です。

接頭語／接尾語フィールド(NumberSignField)

接頭語／接尾語フィールド（NumberSignField クラス）は、接頭語／接尾語を入力するフィールドです。

整数入力フィールド(NumberIntegerPartField)

整数入力フィールド（NumberIntegerPartField クラス）は、整数を入力するフィールドです。

小数点フィールド(NumberDecimalSeparatorField)

小数点フィールド（NumberDecimalSeparatorField クラス）は、小数点を表すフィールドです。

小数入力フィールド(NumberDecimalPartField)

小数入力フィールド（NumberDecimalPartField クラス）は、小数を入力するフィールドです。

ここでは、数値コントロールの表示フィールドに設定可能な7種類のフィールドについて、すべてのフィールドに共通な設定項目と各フィールドに特化した設定項目にわけて解説します。

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

これらのプロパティは、数値コントロールのすべての表示フィールドオブジェクトに共通な設定項目です。

リテラル文字表示フィールド(NumberLiteralDisplayField)

リテラル文字表示フィールド（NumberLiteralDisplayField クラス）は、コントロールに表示するリテラル文字を設定します。

接頭語／接尾語の表示フィールド(NumberSignDisplayField)

接頭語／接尾語の表示フィールド（NumberSignDisplayField クラス）は、接頭語／接尾語を表示するフィールドです。

整数表示フィールド(NumberIntegerPartDisplayField)

整数表示フィールド（NumberIntegerPartDisplayField クラス）は、 整数を表示するフィールドです。

小数点フィールド(NumberDecimalSeparatorDisplayField)

小数点フィールド（NumberDecimalSeparatorDisplayField クラス）は、 小数点を表示するフィールドです。

小数表示フィールド(NumberDecimalPartDisplayField)

小数表示フィールド（NumberDecimalPartDisplayField クラス）は、 小数を表示するフィールドです。

漢数字の表示フィールド(NumberDecimalGeneralFormatDisplayField)

漢数字の表示フィールド（NumberDecimalGeneralFormatDisplayField クラス）は、 漢数字を表示するフィールドです。

下の桁をリテラル文字に置き換えるフィールド(NumberMoneyPatternDisplayField)

下の桁をリテラル文字に置き換えるフィールド（NumberMoneyPatternDisplayField クラス）は、 下３桁を「千」と置き換えるなど、下の桁をリテラル文字に置き換えるフィールドです。

システム書式表示フィールド (NumberSystemFormatDisplayField)

システム書式表示フィールド（NumberSystemFormatDisplayField クラス）は、システムで定義された書式指定子を使用して数字の書式を設定します。

◆ Pattern プロパティに設定可能な書式指定子