PowerTools ActiveReports for .NET 9.0J
系列

系列(Series)は、チャートコントロールでグラフを表示するときのかなめとなるクラスです。チャートコントロールは最低ひとつの系列を持つ必要があります。下の画像では、棒グラフに2つの系列がセットされています。

各系列は、データ点のコレクションを含んでいます。グラフに表示されるすべてのデータ点は系列に属しています。それぞれのデータ点は、1個のX値と、1個以上のY値を含んでいます。多くのタイプのグラフでは、Y値は1個のみを使いますが、バブルチャート、バブルXYチャートなどいくつかのグラフは、複数のY値を持ちます。

データを系列にバインドするときには、X値についてはValueMemberXプロパティ、 Y値についてはValuemMembersYプロパティを使用します。これらのプロパティは、他のコントロールのDataFieldプロパティに似た意味を持っています。

系列は、データ点以外にも、いくつかのプロパティを保持しています。系列が持つプロパティには、グラフの種類(Type)、グラフのカスタムプロパティ、注釈、マーカーなどがあります。

カスタムプロパティ

カスタムプロパティは、グラフの種類ごとに異なる設定を行います。たとえば、棒グラフでは棒の幅、折れ線グラフでは線種、ドーナツグラフでは中心の穴の割合など、それぞれ設定すべき値がありますが、これらの値は、それぞれのグラフの種類に特有なので、Seriesクラスのプロパティとして用意するのは不適当です。これらは、キーとしての文字列(カスタムプロパティ名)と、値としてのオブジェクトのペアとして保持します。 Series.Propertiesプロパティが、それらの値のコレクションとなります。

系列のカスタムプロパティの値は、ChartTypeを変更した場合でもその値が保持されます。グラフの種類によっては反映されないものもありますが、変更前のグラフの種類に戻したい場合などに便利です。

カスタムプロパティの設定方法については「グラフのカスタムプロパティ」を参照してください。

 

 


©2003-2015 GrapeCity inc. All rights reserved.