MESCIUS SPREAD for Windows Forms 17.0J > 開発者ガイド > セル型 > InputManセル > GcTimeSpan型セル > 書式設定(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") |