グラフのカスタムプロパティ

ActiveReportsのChartコントロールの各グラフの種類には、それぞれに適用される固有のプロパティ（カスタムプロパティ）があります。グラフの種類とそのカスタムプロパティは、下の画像のように［プロパティ］ウィンドウ内のSeriesプロパティから展開可能な［Seriesコレクションエディター］ダイアログ、および同ダイアログのPointsプロパティから展開可能な［DataPointコレクションエディター］ダイアログで設定します。

Seriesオブジェクトの特定のプロパティを設定すると、設定は系列内のすべてのデータ点に適用されます。ただし、特定のデータ点に対して既にこのプロパティの値が設定されている場合を除きます。この場合は、データ点のプロパティ設定が系列のプロパティ設定よりも優先され、オーバーライドされます。データソースにバウンドされたグラフでは、ダイアログ内でDataPointコレクションにアクセスしないように注意してください。

設計時にグラフのカスタムプロパティを設定する

設計時にグラフのカスタムプロパティを設定するには、Visual Studio .NETの［プロパティ］ウィンドウからSeries(Collection)プロパティをクリックして［Seriesコレクションエディタ―］ダイアログを開き、Series、またはDataPointオブジェクトのPropertiesプロパティを設定します。

注意: 任意のカスタムプロパティの値を指定した場合、この値は、ChartTypeを変更したときにクリアされません。そのため、特定のChartTypeに適用されないプロパティが表示されますが、ChartTypeを誤って変更した場合に設定が維持される利点があります。

実行時にグラフのカスタムプロパティを設定する

実行時にグラフのSeriesオブジェクト上でカスタムプロパティを設定するには、名前、またはインデックスによって系列を参照し、設定する文字列のPropertiesプロパティを使用します。

Visual Basic

Visual Basicコード	コードのコピー
' バブルチャートのバブルの形状を菱形に設定します。 Me.ChartControl1.Series(0).Properties("Shape") = Chart.MarkerStyle.Diamond

C#コード	コードのコピー
// バブルチャートのバブルの形状を菱形に設定します。 this.chartControl1.Series[0].Properties["Shape"] = GrapeCity.ActiveReports.Chart.MarkerStyle.Diamond;

実行時にグラフのDataPointオブジェクト上でカスタムプロパティを設定するには、名前またはインデックスによって系列を参照し、かつインデックスによってデータ点を参照し、設定する文字列のPropertiesプロパティの名前を使用します。

Visual Basic

Visual Basicコード	コードのコピー
' 系列内の２番目のデータ点に対するドーナツチャート上の分離係数を設定します。 Me.ChartControl1.Series(0).Points(1).Properties("ExplodeFactor") = 0.5F

C#コード	コードのコピー
// 系列内の２番目のデータ点に対するドーナツチャート上の分離係数を設定します。 this.chartControl1.Series[0].Points[1].Properties["ExplodeFactor"] = .5f;

グラフのカスタムプロパティ一覧

注意: カスタムプロパティのプロパティ名は、大文字と小文字が区別されます。

DataPointクラス欄が×となっているプロパティは、Seriesクラスのみに有効なカスタムプロパティです。

プロパティ名	DataPoint クラス	型		グラフの種類	説明
プロパティ名	DataPoint クラス	Visual Basic	C#	グラフの種類	説明
Backdrop		Backdrop	Backdrop	下記以外のすべてのグラフベジェグラフ折れ線グラフ折れ線XYグラフ 3D折れ線グラフ XYプロットグラフ散布図	背景情報を取得、または設定します。
BorderLine		Line	Line	下記以外のすべてのグラフベジェグラフ折れ線グラフ折れ線XYグラフ XYプロットグラフ散布図	線情報を取得、または設定します。
Marker		Marker	Marker	すべて	マーカー情報を取得、または設定します。
ToolTip		LabelInfo	LabelInfo	すべて	ツールチップ情報を取得、または設定します。
BarTopPercent		Single	float	3D棒グラフ 3D横棒グラフ 3D積層棒グラフ 3D積層棒グラフ（％）集合棒グラフ 3Dガントチャート	BarTypesが「Cone」または「Custom」の場合に表示する棒の一番上の割合を取得、または設定します。値は、「０」～「100」の間の整数を設定できます。
BarType		BarType	BarType	3D棒グラフ 3D横棒グラフ 3D積層棒グラフ 3D積層棒グラフ（％）集合棒グラフ 3Dガントチャート	表示する棒タイプを取得、または設定します。値は、「Bar」、「Cylinder」、「Cone」、「Pyramid」、「Custom」です。
BaseStyle		BaseStyle	BaseStyle	3Dファンネルチャート 3Dピラミッドチャート	円形、または四角形の底面描画スタイルを取得、または設定します。このプロパティは、Projectionプロパティが「Orthogonal」に設定されている場合にのみ使用可能です。「CircularBase」か「SqureBase」を設定します。
BodyDownswingBackdrop	×	Backdrop	Backdrop	ローソク足チャート 3Dカギ足チャート練行足チャート 3D練行足チャート新値三本足チャート 3D新値三本足チャート	下落を示す長方形（終値が始値より安い場合）の塗りつぶしに使用する背景情報を取得、または設定します。
BodyUpswingBackdrop	×	Backdrop	Backdrop	ローソク足チャート 3Dカギ足チャート練行足チャート 3D練行足チャート新値三本足チャート 3D新値三本足チャート	上昇を示す長方形（終値が始値より高い場合）の塗りつぶしに使用する背景情報を取得、または設定します。
BodyWidth	×	Single	float	ローソク足チャート	上昇、または下落を示すために使用する長方形の幅を取得、または設定します。
BoxSize		Single	float	ポイント＆フィギュアチャート練行足チャート 3D練行足チャート	別のブロックを作成するために必要な価格の変化量を取得、または設定します。
CalloutLine		Line	Line	ファンネルチャート 3Dファンネルチャートピラミッドチャート 3Dピラミッドチャート	マーカーラベルを対応するファンネルセクションに結ぶ線のスタイルを取得、または設定します。デフォルト値は黒の１ポイント線です。
Clockwise	×	Boolean	bool	ドーナツチャート 3Dドーナツチャート	円グラフの回転方向を取得、または設定します。（「True」の場合：時計回り　「False」の場合：反時計回り）
CloseLine	×	Line	Line	HiLoOpenCloseチャート	終値線の線情報を取得、または設定します。
DownSwingLine		Line	Line	カギ足チャート 3Dカギ足チャートポイント＆フィギュアチャート	下降のスタイルと色設定を取得、または設定します。
ExplodeFactor		Single	float	ドーナツチャート 3Dドーナツチャート	ドーナツチャートの各セグメントの間隔を取得、または設定します。値は、０～１の間の小数を設定できます。１つのセグメントだけを分離させるには、SeriesオブジェクトではなくDataPointオブジェクトのExplodeFactorプロパティを設定します。
FunnelStyle		FunnelStyle	FunnelStyle	ファンネルチャート 3Dファンネルチャート	ファンネルの幅、または高さに対するY値を取得、または設定します。デフォルト値は「YIsHeight」です。
Gap	×	Single	float	棒グラフ横棒グラフ積層棒グラフ 3D棒グラフ 3D横棒グラフ 3D積層棒グラフ 3D積層棒グラフ（％）集合棒グラフガントチャート 3Dガントチャート	各X軸値の棒の間隔を取得、または設定します。
HiloLine	×	Line	Line	HiLoチャート HiLoOpenCloseチャート	HiLo線の線情報を取得、または設定します。
HoleSize	×	Single	float	ドーナツチャート 3Dドーナツチャート	グラフの内半径を取得、または設定します。「0」に設定した場合、グラフは円グラフのような外観になります。値は、０～１の間の小数を設定することができます。
Line		Line	Line	ベジェグラフベジェXYグラフ折れ線グラフ折れ線XYグラフ	線情報を取得、または設定します。
LineBackdrop	×	Backdrop	Backdrop	3Dエリアグラフ 3D折れ線グラフ 3D折れ線XYグラフ 3Dベジェグラフ	3D線の垂直方向面の背景情報を取得、または設定します。
LineJoin	×	LineJoin	LineJoin	折れ線グラフ折れ線XYグラフ	頂点での線の交わり方を取得、または設定します。
MaxSizeFactor	×	Single	float	バブルチャートバブルXYチャート	バブルの半径の最大サイズを取得、または設定します。値は、０～１の間の小数を設定できます。デフォルト値は「0.25」です。
MaxValue	×	Single	float	バブルチャートバブルXYチャート	最大値として使用するバブルサイズを取得、または設定します。
MinPointHeight		Single	float	ファンネルチャート 3Dファンネルチャートピラミッドチャート 3Dピラミッドチャート	ファンネルチャートのデータ点に許容される最小高さを取得、または設定します。高さは相対座標で測定されます。
MinValue	×	Single	float	バブルチャートバブルXYチャート	最小値として使用するバブルサイズを取得、または設定します。
NeckHeight		Single	float	ファンネルチャート 3Dファンネルチャート	ファンネルチャートのネック高さを取得、または設定します。このプロパティは、FunnelStyleプロパティが「YIsHeight」に設定されている場合にのみ使用できます。デフォルト値は「5」です。
NeckWidth		Single	float	ファンネルチャート 3Dファンネルチャート	ファンネルチャートのネック幅を取得、または設定します。このプロパティは、FunnelStyleプロパティが「YIsHeight」に設定されている場合にのみ使用できます。デフォルト値は「5」です。
NewLineBreak		Integer	int	新値三本足チャート	方向転換するために必要な価格の変動量を取得、または設定します。デフォルト値は「3」です。
OpenLine	×	Line	Line	HiLoOpenCloseチャート	始値線の線情報を取得、または設定します。
OutsideLabels	×	Boolean	bool	ドーナツチャート 3Dドーナツチャートファンネルチャート 3Dファンネルチャートピラミッドチャート 3Dピラミッドチャート	マーカーをグラフの外に表示するかどうかを示す値を取得、または設定します。
OutsideLabelsPlacement		LabelsPlacemen	LabelsPlacemen	ファンネルチャート 3Dファンネルチャートピラミッドチャート 3Dピラミッドチャート	データ点ラベルをピラミッド（ファンネル）の左側と右側のどちらに表示するかを示す値を取得、または設定します。このプロパティは、OutsideLabelsプロパティが「True」に設定されている場合にのみ使用できます。
PointBarDepth		Single	float	3D棒グラフ 3D横棒グラフ 3Dガントチャート	3D線の太さを取得、または設定します。
PointGapPct		Single	float	ファンネルチャート 3Dファンネルチャートピラミッドチャート 3Dピラミッドチャート	データ点の間隔量を取得、または設定します。PointGapPctは相対座標で測定されます。デフォルト値は「0」で、値の有効範囲は「0」～「100」です。
Radius	×	Single	float	ドーナツチャート 3Dドーナツチャート	グラフ領域内におけるグラフのサイズを取得、または設定します。値の有効範囲は「２」以下です。（「1.0」がデフォルトのサイズです）
ReversalAmount		String	string	カギ足チャート 3Dカギ足チャートポイント＆フィギュアチャート	カギ足ラインが方向転換するために必要な価格変動量を取得、または設定します。
RotationAngle		Single	float	3D棒グラフ 3D横棒グラフ集合棒グラフ 3Dファンネルチャート 3Dピラミッドチャート 3Dガントチャート	カスタム3D棒形状の水平開始角度を取得、または設定します。BarTypeプロパティが「Custome」の場合のみ有効です。
Shape		MarkerStyle	MarkerStyle	バブルチャートバブルXYチャート	バブルの形状を取得、または設定します。有効なMarkerStyle列挙値を使用するか返します。
StartAngle	×	Single	float	ドーナツチャート 3Dドーナツチャート	系列のデータ点の水平開始角度を取得、または設定します。
Tension	×	Single	float	ベジェグラフ 3DベジェグラフベジェXYグラフ 3DベジェXYグラフ	曲線のカーブの強さを取得、または設定します。
Thickness	×	Single	float	3Dエリアグラフ 3D折れ線グラフ 3D折れ線XYグラフ	3D線の太さを取得、または設定します。
TickLen	×	Single	float	HiLoOpenCloseチャート	始値線と終値線の目盛の長さを取得、または設定します。
UpswingLine		Line	Line	カギ足チャート 3Dカギ足チャートポイント＆フィギュアチャート	上昇のスタイルと色設定を取得、または設定します。
VertexNumber		Integer	int	3D棒グラフ 3D横棒グラフ 3D積層棒グラフ 3D積層棒グラフ（％）集合棒グラフ 3Dガントチャート	カスタム棒タイプの上方面の頂点の数を取得、または設定します。つまり、このプロパティを「6」と設定した場合、上方面は六角形となります。BarTypeプロパティの値は「Custome」に設定されている必要があります。値は「3」以上でなければなりません。
WickLine	×	Line	Line	ローソク足チャート	芯線の線情報を取得、または設定します。
Width	×	Single	float	3Dエリアグラフ 3D折れ線グラフ 3D折れ線XYグラフ 3Dベジェグラフ 3DベジェXYグラフ 3Dカギ足チャート 3D積層エリアグラフ 3D積層エリアグラフ（％）	3D線の上方面の幅を取得、または設定します。