GrapeCity InputMan for Windows Forms 10.0J
キーワードによる書式設定

ここでは、キーワードによる書式設定について説明します。

概要

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

キーワードによる書式設定は、4.0J以前の数値コントロールで利用されていた方法と同様の方法です。

設定方法

コードによる設定

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

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

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

Pattern, positive prefix, positive suffix, negative prefix, negattive suffix
' キーワードから書式を設定します。
GcNumber1.Fields.SetFields("####0.00,,,-,")
GcNumber1.DisplayFields.AddRange("####0.00,,,-,")
// キーワードから書式を設定します。
gcNumber1.Fields.SetFields("####0.00,,,-,");
gcNumber1.DisplayFields.AddRange("####0.00,,,-,");

なお、AddRange メソッドにより書式を設定する場合でも、自動的にフィールドオブジェクトに変換されているため、設定後に特定のフィールドスタイルを変更することが可能です。

次のサンプルコードは、キーワードにより設定した数値書式で特定のフィールドのスタイルを設定する例です。

' 入力書式フィールドのスタイルを設定します。
GcNumber1.Fields(0).BackColor = Color.Bisque
GcNumber1.Fields(1).ForeColor = Color.DarkGray
GcNumber1.Fields(2).Font = New Font("Meiryo UI", 12)

' 表示書式フィールドのスタイルを設定します。
GcNumber1.DisplayFields(0).Font = New Font("MS ゴシック", 15)
GcNumber1.DisplayFields(1).BackColor = Color.Yellow
GcNumber1.DisplayFields(2).ForeColor = Color.Gray
// 入力書式フィールドのスタイルを設定します。
gcNumber1.Fields[0].BackColor = Color.Bisque;
gcNumber1.Fields[1].ForeColor = Color.DarkGray;
gcNumber1.Fields[2].Font = new Font("Meiryo UI", 12);

// 表示書式フィールドのスタイルを設定します。
gcNumber1.DisplayFields[0].Font = new Font("MS ゴシック", 15);
gcNumber1.DisplayFields[1].BackColor = Color.Yellow;
gcNumber1.DisplayFields[2].ForeColor = Color.Gray;

デザイン画面での設定

デザイン画面では「入力書式の設定」「表示書式の設定」エディタを使用して容易な設定が可能です。これらのエディタは次のいずれかの方法で起動でき、数値のキーワードを設定することで書式を作成します。

入力書式 表示書式

個々のフィールドのプロパティは設定できませんが、桁区切りや漢数字などの書式が予めビルトイン書式として用意されているため、これらのリストから書式を選択するだけで簡単に書式を定義することが可能です。

「表示書式の設定」エディタ

「表示書式の設定」エディタ

入力書式のキーワード

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

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

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

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

 

 


© 2004 GrapeCity inc. All rights reserved.