MESCIUS InputMan for Windows Forms 12.0J > InputManの使い方 > タイムスパンコントロール > 書式の設定 > フィールドオブジェクトによる書式設定 |
ここでは、フィールドオブジェクトによる書式設定について説明します。
入力時の書式を設定する入力フィールドには、次の7種類のフィールドが提供されており、これらのフィールドオブジェクトを使って書式を設定することができます。
また、表示フィールドでは、次の7種類のフィールドが提供されています。
これらのフィールドオブジェクトをTimeSpanFieldCollection または、TimeSpanDisplayFieldCollection コレクションに追加することでタイムスパンの書式を作成します。
タイムスパンの書式は、入力および表示用の各フィールドコレクションに、前項で解説したフィールドオブジェクトを組み合わせて作成します。
入力書式を設定するには、Add またはAddRange メソッドを使用して、TimeSpanFieldCollection コレクションに入力用フィールドオブジェクトを追加します。表示書式は、Add またはAddRange メソッドを使用して、表示用フィールドオブジェクトをTimeSpanDisplayFieldCollection コレクションに追加します。
次のサンプルコードは、タイムスパンコントロールに入力および表示書式を設定する例です。
(図) 上記サンプルコードを適用したコントロール
フィールドオブジェクトをTimeSpanFieldCollection または TimeSpanDisplayFieldCollection コレクションから削除するには、Remove メソッドまたは、RemoveAt メソッドを使用します。
次のサンプルコードは、TimeSpanFieldCollection コレクションの先頭のフィールドを削除する例です。
デザイン画面ではフィールドオブジェクトを設定できる「入力フィールドの編集」「表示フィールドの編集」エディタから容易な設定が可能です。 このエディタは次のいずれかの方法で起動でき、タイムスパンコントロールで設定可能なフィールドを組み合わせて設定します。
入力書式![]() 「入力フィールドの編集」エディタ |
このエディタでは、コレクションにフィールドを追加や編集すると同時に各フィールドのテキストのフォントや色といったスタイルを設定することができます。
(図)フィールド毎に異なったスタイルを設定
ここでは、タイムスパンコントロールの入力フィールドに設定可能な7種類のフィールドについて、すべてのフィールドに共通な設定項目と各フィールドに特化した設定項目にわけて解説します。
これらのプロパティは、タイムスパンコントロールのすべての入力フィールドオブジェクトに共通な設定項目です。
プロパティ | 説明 |
---|---|
BackColor | フィールド背景色を設定します。 |
Font | フィールドに表示される文字列のフォントを設定します。 |
ForeColor | フィールド前景色を設定します。 |
Margin | フィールド領域の外枠の距離を設定します。 コントロールの境界線からの距離や、他のフィールドとの間隔を設定する際に使用します。 |
Padding | フィールド領域からテキストの表示エリアまでの距離を設定します。 |
リテラル文字フィールド(TimeSpanLiteralField クラス)は、コントロールに表示するリテラル文字を設定します。
プロパティ | 説明 |
---|---|
Text | リテラル文字として表示する文字列を設定します。 |
符号入力フィールド(TimeSpanSignField クラス)は、符号を入力するフィールドです。
プロパティ | 説明 |
---|---|
NegativePattern | 負数値の符号を設定します。 |
PositivePattern | 正数値の符号を設定します。 |
日入力フィールド(TimeSpanDayField クラス)は、日数を入力するフィールドです。
プロパティ | 説明 |
---|---|
Digits | フィールドの桁数を設定します。 |
PromptChar | プロンプト文字を設定します。 |
SpinIncrement | スピン機能による値の変化量を設定します。 |
時間入力フィールド(TimeSpanHourField クラス)は、時間を入力するフィールドです。
プロパティ | 説明 |
---|---|
Digits | フィールドの桁数を設定します。 |
PromptChar | プロンプト文字を設定します。 |
SpinIncrement | スピン機能による値の変化量を設定します。 |
分入力フィールド(TimeSpanMinuteField クラス)は、分数を入力するフィールドです。
プロパティ | 説明 |
---|---|
Digits | フィールドの桁数を設定します。 |
PromptChar | プロンプト文字を設定します。 |
SpinIncrement | スピン機能による値の変化量を設定します。 |
秒入力フィールド(TimeSpanSecondField クラス)は、秒数を入力するフィールドです。
プロパティ | 説明 |
---|---|
Digits | フィールドの桁数を設定します。 |
PromptChar | プロンプト文字を設定します。 |
SpinIncrement | スピン機能による値の変化量を設定します。 |
小数入力フィールド(TimeSpanDecimalField クラス)は、小数を入力するフィールドです。
プロパティ | 説明 |
---|---|
Digits | フィールドの桁数を設定します。 |
PromptChar | プロンプト文字を設定します。 |
SpinIncrement | スピン機能による値の変化量を設定します。 |
ここでは、タイムスパンコントロールの表示フィールドに設定可能な7種類のフィールドについて、すべてのフィールドに共通な設定項目と各フィールドに特化した設定項目にわけて解説します。
これらのプロパティは、タイムスパンコントロールのすべての表示フィールドオブジェクトに共通な設定項目です。
プロパティ | 説明 |
---|---|
BackColor | フィールド背景色を設定します。 |
Font | フィールドに表示される文字列のフォントを設定します。 |
ForeColor | フィールド前景色を設定します。 |
Margin | フィールド領域の外枠の距離を設定します。 コントロールの境界線からの距離や、他のフィールドとの間隔を設定する際に使用します。 |
Padding | フィールド領域からテキストの表示エリアまでの距離を設定します。 |
リテラル文字表示フィールド(TimeSpanLiteralDisplayField クラス)は、コントロールに表示するリテラル文字を設定します。
プロパティ | 説明 |
---|---|
Text | リテラル文字として表示する文字列を設定します。 |
符号表示フィールド(TimeSpanSignDisplayField クラス)は、符号を表示するフィールドです。
プロパティ | 説明 |
---|---|
NegativePattern | 負数値の符号を設定します。 |
PositivePattern | 正数値の符号を設定します。 |
日表示フィールド(TimeSpanDayDisplayField クラス)は、日数を表示するフィールドです。
プロパティ | 説明 |
---|---|
Digits | フィールドの桁数を設定します。 |
PromptChar | プロンプト文字を設定します。 |
時間表示フィールド(TimeSpanHourDisplayField クラス)は、時間を表示するフィールドです。
プロパティ | 説明 |
---|---|
Digits | フィールドの桁数を設定します。 |
PromptChar | プロンプト文字を設定します。 |
分表示フィールド(TimeSpanMinuteDisplayField クラス)は、分数を表示するフィールドです。
プロパティ | 説明 |
---|---|
Digits | フィールドの桁数を設定します。 |
PromptChar | プロンプト文字を設定します。 |
秒表示フィールド(TimeSpanSecondDisplayField クラス)は、秒数を表示するフィールドです。
プロパティ | 説明 |
---|---|
Digits | フィールドの桁数を設定します。 |
PromptChar | プロンプト文字を設定します。 |
小数表示フィールド(TimeSpanDecimalDisplaylField クラス)は、小数を表示するフィールドです。
プロパティ | 説明 |
---|---|
Digits | フィールドの桁数を設定します。 |
PromptChar | プロンプト文字を設定します。 |