バージョン

SetComboChartSourceData メソッド

コンボ チャートのソース データ範囲を設定します。
シンタックス
'宣言
 
Public Sub SetComboChartSourceData( _
   ByVal dataRange As String, _
   ByVal seriesChartTypes() As ChartType, _
   Optional ByVal plotByRows As Boolean, _
   Optional ByVal cellReferenceMode As Nullable(Of CellReferenceMode) _
) 
public void SetComboChartSourceData( 
   string dataRange,
   ChartType[] seriesChartTypes,
   bool plotByRows,
   Nullable<CellReferenceMode> cellReferenceMode
)

パラメータ

dataRange
コンボ チャートのデータ範囲
seriesChartTypes
指定した dataRange から得られる各シリーズのチャート タイプを指定する ChartType 定数の配列。
plotByRows
オプション。True の場合、行別に各行は別のシリーズとして描画されて、false の場合、列別に各列は別のシリーズとして描画されます。デフォルトは False です。
cellReferenceMode
オプション。dataRange を解析する方法を決定します。
例外
例外解説
System.ExceptionChartType プロパティのデフォルト値は Combo ではありません。
System.NotSupportedException指定された seriesChartTypes 配列に 1 つ以上のコンボ チャート内でサポートされ値が含まれています。
System.NotSupportedException指定された seriesChartTypes 配列は、最大許容軸数 (2) を超えて必要とする値の組み合わせを含みます。
解説

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

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

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

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

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

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

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

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

SeriesType ChartType(コンボ チャートでサポート)
エリア チャート Area、AreaStacked、AreaStacked100
ColumnClustered、ColumnStacked、ColumnStacked100、BarClustered、 BarStacked、BarStacked100、BarOfPie
折れ線チャート Line、LineStacked, LineStacked100, LineMarkers, LineMarkersStacked, LineMarkersStacked100
Pie、PieExploded、PieOfPie、Doughnut、DoughnutExploded
レーダー Radar、RadarFilled、RadarMarkers
散布図 XYScatter、XYScatterLines、XYScatterLinesNoMarkers、XYScatterSmooth、XYScatterSmoothNoMarkers
バブル サポートされません。
サーフェイス サポートされません。

コンボ チャートは最大 2 つの軸グループをサポートします。seriesChartTypes 配列内の値の組み合わせに 2 つ以上の軸グループが必要な場合は、例外がスローされます。

コンボ チャートには少なくとも 2 つの Infragistics.Documents.Excel.Charts.Series 必要です。指定された dataRange の結果が 2 つのシリーズより少ない場合、例外がスローされます。

コンボ チャートで使用されるシリーズの組み合わせが非コンボ チャートと区別がつかない場合、そのチャートは Excel によってコンボ チャートとして認識されない可能性があります。たとえば、Radar 型と RadarMarkers 型の 2 つのシリーズを追加することは有効な組み合わせです。ただし、Excel で開いた場合、シリーズの組み合わせには複数のチャート要素が必要ないため、このようなチャートはコンボ チャートとして認識されません。ただし、関連するすべてのプロパティ値は保持されて、元のチャートとシリアル化されたチャートとの間に明確な違いはありません。

参照