数値コントロールの書式には、入力用と表示用の２つがあり、それぞれ入力フィールドと表示フィールドを使って書式を設定します。

入力フィールドを設定するには、NumberFieldSet オブジェクトの各プロパティを使用します。一般的に数値の整数値、小数点、小数値は配置の順番が決まっているため、NumberFieldSet オブジェクトでは必要なフィールドオブジェクトと、それらを参照するためのプロパティがあらかじめ定義されており、ユーザーがフィールドオブジェクトを個別に追加または削除することはできません。

一方、表示フィールドを設定するには、DisplayFields プロパティが参照する NumberDisplayFieldCollection を使用します。NumberDisplayFieldCollection は、コントロール内の各フィールドを表す NumberDisplayField のコレクションを保持するクラスです。

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

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

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

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

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

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

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

' 表示フィールドのオブジェクトを作成します。 
Dim numberSignDisplayField1 As New NumberSignDisplayField("\", "\-")
Dim numberIntegerPartDisplayField1 As New NumberIntegerPartDisplayField()
Dim numberDecimalSeptorDisplayField1 As New NumberDecimalSeptorDisplayField()
Dim numberDecimalPartDisplayField1 As New NumberDecimalPartDisplayField()
Dim numberSignDisplayField2 As New NumberSignDisplayField("（税込）", "（税込）")

' フィールドをコレクションに追加してコントロールに表示書式を設定します。 
GcNumber1.DisplayFieldSet.DisplayFields.AddRange(New NumberDisplayField() {
  numberSignDisplayField1, numberIntegerPartDisplayField1,
  numberDecimalSeptorDisplayField1, numberDecimalPartDisplayField1,
  numberSignDisplayField2
})

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

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

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

<im:GcNumber>
  <im:GcNumber.DisplayFieldSet>
    <im:NumberDisplayFieldSet>
      <im:NumberSignDisplayField NegativePattern="\-" PositivePattern="\" />
      <im:NumberIntegerPartDisplayField>
        <im:NumberIntegerPartDisplayField.GroupSizes>
          <im:IntegerItem Value="3" />
        </im:NumberIntegerPartDisplayField.GroupSizes>
      </im:NumberIntegerPartDisplayField>
      <im:NumberDecimalSeptorDisplayField />
      <im:NumberDecimalPartDisplayField />
      <im:NumberSignDisplayField NegativePattern="（税込）" PositivePattern="（税込）" />
    </im:NumberDisplayFieldSet>
  </im:GcNumber.DisplayFieldSet>
</im:GcNumber>

（図）：上記サンプルコードを適用したコントロール

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

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

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

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

ここでは、数値コントロールの入力フィールドに設定可能な４種類のフィールドについて解説します。

ここでは、数値コントロールの表示フィールドに設定可能な7種類のフィールドについて解説します。