MESCIUS SPREAD for Windows Forms 17.0J
書式設定(GcTimeSpan型セル)

GcTimeSpan型セルの主要機能である書式フィールドの設定とその活用方法について解説します。

書式設定の概要

タイムスパンコントロールの書式には、入力用と表示用の2つがあり、それぞれ入力フィールドと表示フィールドを使って書式を設定します。
入力フィールドを設定するには、Fields プロパティが参照するTimeSpanFieldCollectionInfo を使用します。TimeSpanFieldCollectionInfoは、各入力フィールドを表すTimeSpanFieldInfo のコレクションを保持するクラスです。
一方、表示フィールドを設定するには、DisplayFields プロパティが参照するTimeSpanDisplayFieldCollectionInfo を使用します。TimeSpanDisplayFieldCollectionはInfo、各表示フィールドを表すTimeSpanDisplayFieldInfo のコレクションを保持するクラスです。

タイムスパンコントロールの書式を設定するには、それぞれのコレクションのAdd メソッドもしくはAddRange メソッドを使用して直接フィールドオブジェクトを追加する方法と、AddRange メソッドのオーバーライドの1つを使用して、キーワード文字列によりフィールドを自動生成する方法があります。それぞれの方法による書式の設定方法については、以下のトピックを参照してください。

フィールドの操作方法
フィールドコレクション内の特定のフィールドにアクセスする場合、次のいずれかの方法を使うことができます。

コレクションのインデックスがわかっている場合は、インデックスを使ってフィールドを取得することができます。
次のサンプルはインデックスを使ってフィールドを取得する例です。ここではタイムスパンコントロールの3番目のフィールドを取得する例です。

サンプルコード

次のサンプル コードは、インデックスを使ってフィールドを取得する例です。ここではGcTimeSpan型セルの3番目のフィールドを取得する例です。

C#
コードのコピー
GrapeCity.Win.Spread.InputMan.CellType.GcTimeSpanCellType gcTimeSpan1 = new GrapeCity.Win.Spread.InputMan.CellType.GcTimeSpanCellType();
GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanFieldInfo myField = gcTimeSpan1.Fields[2];
Visual Basic
コードのコピー
Dim gcTimeSpan1 As New GrapeCity.Win.Spread.InputMan.CellType.GcTimeSpanCellType()
Dim myField As GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanFieldInfo = gcTimeSpan1.Fields(2)

また、インデックスを使わず、設定したキー(文字列)を使って特定のフィールドにアクセスすることもできます。キーは、各フィールドのName プロパティにキーとして文字列を設定します。

次のサンプル コードは、キーを使ってフィールドを取得する例です。ここではTime型セルの特定のフィールドのName プロパティにあらかじめ"Key1"という文字列が設定されていることを前提にしています。

C#
コードのコピー
GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanFieldInfo myField = gdcell.Fields["Key1"];
Visual Basic
コードのコピー
Dim myField As GrapeCity.Win.Spread.InputMan.CellType.Fields.TimeSpanFieldInfo = gdcell.Fields("Key1")
参照

 

 


© MESCIUS inc. All rights reserved.