MESCIUS SPREAD for Windows Forms 17.0J
フィールドオブジェクトによる書式設定(GcTimeSpan型セル)

ここでは、フィールドオブジェクトによる書式設定について説明します。

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

フィールド(クラス) 説明
TimeSpanLiteralFieldInfo リテラル文字フィールド
TimeSpanSignFieldInfo 符号入力フィールド
TimeSpanDayFieldInfo 日入力フィールド
TimeSpanHourFieldInfo 時間入力フィールド
TimeSpanMinuteFieldInfo 分入力フィールド
TimeSpanSecondFieldInfo 秒入力フィールド
TimeSpanDecimalFieldInfo 小数入力フィールド

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

フィールド(クラス) 説明
TimeSpanLiteralDisplayFieldInfo リテラル文字フィールド
TimeSpanSignDisplayFieldInfo 符号表示フィールド
TimeSpanDayDisplayFieldInfo 日表示フィールド
TimeSpanHourDisplayFieldInfo 時間表示フィールド
TimeSpanMinuteDisplayFieldInfo 分表示フィールド
TimeSpanSecondDisplayFieldInfo 秒表示フィールド
TimeSpanDecimalDisplaylFieldInfo 小数表示フィールド
フィールドの追加と削除

タイムスパンの書式は、入力および表示用の各フィールドコレクションに、前項で解説したフィールドオブジェクトを組み合わせて作成します。

入力書式を設定するには、Add またはAddRange メソッドを使用して、TimeSpanFieldCollectionInfo に入力用フィールドオブジェクトを追加します。表示書式は、Add またはAddRange メソッドを使用して、表示用フィールドオブジェクトをTimeSpanDisplayFieldCollectionInfo に追加します。

サンプルコード

次のサンプルコードは、以下の図のようにGcTimeSpan型セルに入力および表示書式を設定する例です。

  

C#
コードのコピー
GrapeCity.Win.Spread.InputMan.CellType.GcTimeSpanCellType gcTimeSpan1 = new GrapeCity.Win.Spread.InputMan.CellType.GcTimeSpanCellType();
// フィールドをクリアします。
gcTimeSpan1.Fields.Clear();
gcTimeSpan1.DisplayFields.Clear();
// 入力フィールドのオブジェクトを作成します。
GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanHourFieldInfo timeSpanHourField1 = new GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanHourFieldInfo(2);
GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanLiteralFieldInfo timeSpanLiteralField1 = new GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanLiteralFieldInfo(":");
GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanMinuteFieldInfo timeSpanMinuteField1 = new GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanMinuteFieldInfo(2);
// フィールドをコレクションに追加してコントロールに入力書式を設定します。
gcTimeSpan1.Fields.AddRange(new GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanFieldInfo[] {
    timeSpanHourField1, timeSpanLiteralField1,  timeSpanMinuteField1});
// 表示フィールドのオブジェクトを作成します。
GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanHourDisplayFieldInfo timeSpanHourDisplayField1 = new GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanHourDisplayFieldInfo();
GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanLiteralDisplayFieldInfo timeSpanLiteralDisplayField1 = new GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanLiteralDisplayFieldInfo("時間");
GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanMinuteDisplayFieldInfo timeSpanMinuteDisplayField1 = new GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanMinuteDisplayFieldInfo();
GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanLiteralDisplayFieldInfo timeSpanLiteralDisplayField2 = new GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanLiteralDisplayFieldInfo("分");
// フィールドをコレクションに追加してコントロールに表示書式を設定します。
gcTimeSpan1.DisplayFields.AddRange(new GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanDisplayFieldInfo[] {
    timeSpanHourDisplayField1, timeSpanLiteralDisplayField1,
    timeSpanMinuteDisplayField1, timeSpanLiteralDisplayField2});
fpSpread1.ActiveSheet.Cells[0, 0].CellType = gcTimeSpan1;
Visual Basic
コードのコピー
Dim gcTimeSpan1 As New GrapeCity.Win.Spread.InputMan.CellType.GcTimeSpanCellType()
' フィールドをクリアします。
gcTimeSpan1.Fields.Clear()
gcTimeSpan1.DisplayFields.Clear()
' 入力フィールドのオブジェクトを作成します。
Dim timeSpanHourField1 As New GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanHourFieldInfo(2)
Dim timeSpanLiteralField1 As New GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanLiteralFieldInfo(":")
Dim timeSpanMinuteField1 As New GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanMinuteFieldInfo(2)
' フィールドをコレクションに追加してコントロールに入力書式を設定します。
gcTimeSpan1.Fields.AddRange(New GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanFieldInfo() {timeSpanHourField1, timeSpanLiteralField1, timeSpanMinuteField1})
' 表示フィールドのオブジェクトを作成します。
Dim timeSpanHourDisplayField1 As New GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanHourDisplayFieldInfo()
Dim timeSpanLiteralDisplayField1 As New GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanLiteralDisplayFieldInfo("時間")
Dim timeSpanMinuteDisplayField1 As New GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanMinuteDisplayFieldInfo()
Dim timeSpanLiteralDisplayField2 As New GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanLiteralDisplayFieldInfo("分")
' フィールドをコレクションに追加してコントロールに表示書式を設定します。
gcTimeSpan1.DisplayFields.AddRange(New GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanDisplayFieldInfo() {timeSpanHourDisplayField1, timeSpanLiteralDisplayField1, timeSpanMinuteDisplayField1, timeSpanLiteralDisplayField2})
FpSpread1.ActiveSheet.Cells(0, 0).CellType = gcTimeSpan1

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

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

C#
コードのコピー
// コレクションの先頭のオブジェクトを削除
GrapeCity.Win.Spread.InputMan.CellType.GcTimeSpanCellType cell = (fpSpread1.ActiveSheet.GetCellType(0, 0) as GrapeCity.Win.Spread.InputMan.CellType.GcTimeSpanCellType);
cell.Fields.RemoveAt(0);
Visual Basic
コードのコピー
' コレクションの先頭のオブジェクトを削除
Dim cell As GrapeCity.Win.Spread.InputMan.CellType.GcTimeSpanCellType = TryCast(FpSpread1.ActiveSheet.GetCellType(0, 0), GrapeCity.Win.Spread.InputMan.CellType.GcTimeSpanCellType)
cell.Fields.RemoveAt(0)
入力フィールドオブジェクト

ここでは、GcTimeSpan型セルの入力フィールドに設定可能な7種類のフィールドについて、すべてのフィールドに共通な設定項目と各フィールドに特化した設定項目にわけて解説します。

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

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

プロパティ 説明
BackColor フィールド背景色を設定します。
Font フィールドに表示される文字列のフォントを設定します。
ForeColor フィールド前景色を設定します。
Margin フィールド領域の外枠の距離を設定します。
セルの境界線からの距離や、他のフィールドとの間隔を設定する際に使用します。
Padding フィールド領域からテキストの表示エリアまでの距離を設定します。

リテラル文字フィールド(TimeSpanLiteralFieldInfo)

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

プロパティ 説明
Text リテラル文字として表示する文字列を設定します。

符号入力フィールド (TimeSpanSignFieldInfo)

符号入力フィールド(TimeSpanSignFieldInfo クラス)は、符号を入力するフィールドです。

プロパティ 説明
NegativePattern 負数値の符号を設定します。
PositivePattern 正数値の符号を設定します。

日入力フィールド(TimeSpanDayFieldInfo)

日入力フィールド(TimeSpanDayFieldInfo クラス)は、日数を入力するフィールドです。

プロパティ 説明
Digits フィールドの桁数を設定します。
PromptChar プロンプト文字を設定します。
SpinIncrement スピン機能による値の変化量を設定します。

時間入力フィールド(TimeSpanHourFieldInfo)

時間入力フィールド(TimeSpanHourFieldInfo クラス)は、時間を入力するフィールドです。

プロパティ 説明
Digits フィールドの桁数を設定します。
PromptChar プロンプト文字を設定します。
SpinIncrement スピン機能による値の変化量を設定します。

分入力フィールド(TimeSpanMinuteFieldInfo)

分入力フィールド(TimeSpanMinuteFieldInfo クラス)は、分数を入力するフィールドです。

プロパティ 説明
Digits フィールドの桁数を設定します。
PromptChar プロンプト文字を設定します。
SpinIncrement スピン機能による値の変化量を設定します。

秒入力フィールド(TimeSpanSecondFieldInfo)

秒入力フィールド(TimeSpanSecondFieldInfo クラス)は、秒数を入力するフィールドです。

プロパティ 説明
Digits フィールドの桁数を設定します。
PromptChar プロンプト文字を設定します。
SpinIncrement スピン機能による値の変化量を設定します。

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

小数入力フィールド(TimeSpanDecimalField クラス)は、小数を入力するフィールドです。

プロパティ 説明
Digits フィールドの桁数を設定します。
PromptChar プロンプト文字を設定します。
SpinIncrement スピン機能による値の変化量を設定します。
表示フィールドオブジェクト

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

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

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

プロパティ 説明
BackColor フィールド背景色を設定します。
Font フィールドに表示される文字列のフォントを設定します。
ForeColor フィールド前景色を設定します。
Margin フィールド領域の外枠の距離を設定します。
セルの境界線からの距離や、他のフィールドとの間隔を設定する際に使用します。
Padding フィールド領域からテキストの表示エリアまでの距離を設定します。

リテラル文字フィールド(TimeSpanLiteralDisplayFieldInfo)

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

プロパティ 説明
Text リテラル文字として表示する文字列を設定します。

符号表示フィールド(TimeSpanSignDisplayFieldInfo)

符号表示フィールド(TimeSpanSignDisplayFieldInfo クラス)は、符号を表示するフィールドです。

プロパティ 説明
NegativePattern 負数値の符号を設定します。
PositivePattern 正数値の符号を設定します。

日表示フィールド(TimeSpanDayDisplayFieldInfo)

日表示フィールド(TimeSpanDayDisplayFieldInfo クラス)は、日数を表示するフィールドです。

プロパティ 説明
Digits フィールドの桁数を設定します。
PromptChar プロンプト文字を設定します。

時間表示フィールド(TimeSpanHourDisplayFieldInfo)

時間表示フィールド(TimeSpanHourDisplayFieldInfo クラス)は、時間を表示するフィールドです。

プロパティ 説明
Digits フィールドの桁数を設定します。
PromptChar プロンプト文字を設定します。

分表示フィールド(TimeSpanMinuteDisplayFieldInfo)

分表示フィールド(TimeSpanMinuteDisplayFieldInfo クラス)は、分数を表示するフィールドです。

プロパティ 説明
Digits フィールドの桁数を設定します。
PromptChar プロンプト文字を設定します。

秒表示フィールド(TimeSpanSecondDisplayFieldInfo)

秒表示フィールド(TimeSpanSecondDisplayFieldInfo クラス)は、秒数を表示するフィールドです。

プロパティ 説明
Digits フィールドの桁数を設定します。
PromptChar プロンプト文字を設定します。

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

小数表示フィールド(TimeSpanDecimalDisplaylFieldInfo クラス)は、小数を表示するフィールドです。

プロパティ 説明
Digits フィールドの桁数を設定します。
PromptChar プロンプト文字を設定します。
参照

 

 


© MESCIUS inc. All rights reserved.