'宣言 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 )
| 例外 | 解説 |
|---|---|
| System.Exception | ChartType プロパティのデフォルト値は Combo ではありません。 |
| System.NotSupportedException | 指定された seriesChartTypes 配列に 1 つ以上のコンボ チャート内でサポートされ値が含まれています。 |
| System.NotSupportedException | 指定された seriesChartTypes 配列は、最大許容軸数 (2) を超えて必要とする値の組み合わせを含みます。 |
コンボ チャートはメイン チャート内の複数のチャート タイプをサポートし、それぞれの異なるチャート タイプは 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 値をシリーズ タイプ別にまとめたものです。
| 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 で開いた場合、シリーズの組み合わせには複数のチャート要素が必要ないため、このようなチャートはコンボ チャートとして認識されません。ただし、関連するすべてのプロパティ値は保持されて、元のチャートとシリアル化されたチャートとの間に明確な違いはありません。