SetComboChartSourceData メソッド

'宣言
 
Public Sub SetComboChartSourceData( _
   ByVal dataRange As System.String, _
   ByVal seriesChartTypes() As ChartType, _
   Optional ByVal plotByRows As System.Boolean, _
   Optional ByVal cellReferenceMode As System.Nullable(Of CellReferenceMode) _
) 

public void SetComboChartSourceData( 
   System.string dataRange,
   ChartType[] seriesChartTypes,
   System.bool plotByRows,
   System.Nullable<CellReferenceMode> cellReferenceMode
)

パラメータ

dataRange

コンボ チャートのデータ範囲

seriesChartTypes

指定した dataRange から得られる各シリーズのチャート タイプを指定する ChartType 定数の配列。

plotByRows

オプション。True の場合、行別に各行は別のシリーズとして描画されて、false の場合、列別に各列は別のシリーズとして描画されます。デフォルトは False です。

cellReferenceMode

オプション。dataRange を解析する方法を決定します。

コンボ チャートはメイン チャート内の複数のチャート タイプをサポートし、それぞれの異なるチャート タイプは 1 つ以上の Infragistics.Documents.Excel.Charts.Series に関連付けられています。

このメソッドを使用して、コンボ チャートの SeriesCollection を作成します。

たとえば、3 つのシリーズを生成する dataRange が与えられた場合、呼び出し元は seriesChartTypes パラメーターの値として3つの要素を持つ配列を指定できます。次に、各配列要素は、配列内に現れる順序と同じ順序で対応するシリーズに適用されます。

重複した ChartType 値が seriesChartTypes 配列に表示されることがあります。その場合、対応するシリーズは同じチャートに表示されます。たとえば、ClusteredColumn、Line および Line 結果で配列を指定すると、最初のシリーズがクラスター柱状チャート表示され、残りのシリーズが折れ線チャートに表示されます。

seriesChartTypes パラメーターの値に null を指定すると、 'ColumnClustered’ と 'Line’ を含む 2 要素の配列と同じように扱われ、最初のシリーズのクラスター柱状チャートと残りのシリーズの折れ線チャートになります。

指定された seriesChartTypes から得られるシリーズの数はdataRange のシリーズの数より少ない場合、 残りのシリーズは seriesChartTypes 配列の最後の要素として同じ ChartTypeとAxisGroup を取得します。返されたシリーズの数よりも多くの値が配列に存在する場合、これらの値は無視されます。

特定のチャート タイプの値はコンボ チャートには無効です。これらのチャート タイプのいずれかが配列に存在する場合、例外がスローされ、無効なチャート タイプがリストされます。

次の表は、コンボ チャートでサポートされている ChartType 値をシリーズ タイプ別にまとめたものです。