チャートのカスタマイズ
チャートの作成
Aspose.Cellsでさまざまなチャートをスプレッドシートに追加できます。Aspose.Cellsは多くの柔軟なチャートオブジェクトを提供します。このトピックでは、Aspose.Cellsのチャートオブジェクトについて説明します。
単純なチャートの作成
Aspose.Cellsを使用して、次のような例コードで簡単にグラフを作成できます。
グラフの作成に関する事項
Aspose.Cellsを使用してチャートを作成する際に役立ついくつかの基本的な概念を理解することが重要です。
チャートオブジェクト
Aspose.Cellsは、あらゆる種類のグラフを作成するために使用される特別なクラス群を提供しています。これらのクラスは グラフオブジェクト を作成するために使用され、グラフの構築ブロックとして機能します。以下にグラフオブジェクトがリストされています:
- Axis、グラフの軸。
- Chart 、単一のExcelグラフ。
- ChartArea、ワークシート内のグラフエリア。
- ChartDataTable、グラフデータテーブル。
- ChartFrame、グラフ内の枠オブジェクト。
- ChartPoint、グラフ内のシリーズ内の単一のポイント。
- ChartPointCollection、1つのシリーズ内のすべてのポイントを含むコレクション。
- ChartCollection、Chartのコレクション。
- DataLabels、指定された Series、ChartPoint、Trendline などのDataLabels。
- FillFormat、形状の塗りつぶし形式。
- Floor、3Dグラフの床。
- Legend、グラフの凡例。
- Line、グラフの線。
- SeriesCollection、Seriesのコレクション。
- Series、グラフ内の単一のデータ系列を表します。
- TickLabels、グラフ軸上の目盛りラベル。
- Title、グラフまたは軸のタイトル。
- Trendline、グラフ内のトレンドライン。
- TrendlineCollection、指定されたデータ系列のすべてのTrendlineオブジェクトのコレクション。
- Walls、3Dグラフの壁。
Chartingオブジェクトの使用
上記のように、すべてのチャートオブジェクトはそれぞれのクラスのインスタンスであり、特定のタスクを実行するための特定のプロパティとメソッドを提供します。チャートオブジェクトを使用して、チャートを作成します。
Aspose.CellsのChartCollectionコレクションを使用してワークシートに任意の種類のグラフを追加できます。ChartCollectionコレクション内の各アイテムはChartオブジェクトを表します。Chartオブジェクトは、グラフの外観をカスタマイズするために必要なグラフオブジェクトをカプセル化しています。次のセクションでは、いくつかの基本的なグラフオブジェクトを使用してシンプルなグラフを作成する方法を示します。
シンプルなグラフの作成
Aspose.Cellsを使用して様々な種類のグラフを作成することができます。Aspose.Cellsでサポートされているすべての標準グラフは、ChartTypeという列挙型で事前定義されています。事前定義されたグラフの種類は次のとおりです:
| チャートの種類 | 説明 |
|---|---|
| Column | クラスター化された縦棒グラフを表します |
| ColumnStacked | 積み上げ列チャートを表します。 |
| Column100PercentStacked | 100% 積み上げ列チャートを表します。 |
| Column3DClustered | 3D クラスタ化された列チャートを表します。 |
| Column3DStacked | 3D 積み上げ列チャートを表します。 |
| Column3D100PercentStacked | 3D 100% 積み上げ列チャートを表します。 |
| Column3D | 3D 列チャートを表します。 |
| Bar | クラスタ化された棒チャートを表します。 |
| BarStacked | 積み上げ棒チャートを表します。 |
| Bar100PercentStacked | 100% 積み上げ棒チャートを表します。 |
| Bar3DClustered | 3D クラスタ化された棒チャートを表します。 |
| Bar3DStacked | 3D 積み上げ棒チャートを表します。 |
| Bar3D100PercentStacked | 3D 100% 積み上げ棒チャートを表します。 |
| Line | 折れ線チャートを表します。 |
| LineStacked | 積み上げ折れ線チャートを表します。 |
| Line100PercentStacked | 100% 積み上げ折れ線チャートを表します。 |
| LineWithDataMarkers | データマーカー付きの折れ線チャートを表します。 |
| LineStackedWithDataMarkers | データマーカー付きの積み上げ折れ線チャートを表します。 |
| Line100PercentStackedWithDataMarkers | データマーカー付きの100% 積み上げ折れ線チャートを表します。 |
| Line3D | 3D 折れ線チャートを表します。 |
| Pie | 円グラフを表します。 |
| Pie3D | 3D 円グラフを表します。 |
| PiePie | パイ オブ パイ チャートを表します。 |
| PieExploded | 分解された円グラフを表します。 |
| Pie3DExploded | 3Dエクスプロード円グラフを表します |
| PieBar | パイチャートのバーを表します |
| Scatter | 散布図を表します |
| ScatterConnectedByCurvesWithDataMarker | 曲線で接続されたデータマーカー付きの散布図を表します |
| ScatterConnectedByCurvesWithoutDataMarker | 曲線で接続された散布図を表します |
| ScatterConnectedByLinesWithDataMarker | データマーカーを使用した線でつながる散布図を表します。 |
| ScatterConnectedByLinesWithoutDataMarker | データマーカーを使用しない線でつながる散布図を表します。 |
| Area | エリアチャートを表します |
| AreaStacked | 積み上げエリアチャートを表します |
| Area100PercentStacked | 100% 積み上げエリアチャートを表します |
| Area3D | 3Dエリアチャートを表します |
| Area3DStacked | 3D積み上げエリアチャートを表します |
| Area3D100PercentStacked | 3D 100% 積み上げエリアチャートを表します |
| Doughnut | ドーナツチャートを表します |
| DoughnutExploded | 分裂したドーナツチャートを表します |
| Radar | レーダーチャートを表します。 |
| RadarWithDataMarkers | データマーカーを使用したレーダーチャートを表します。 |
| RadarFilled | 塗りつぶしのレーダーチャートを表します |
| Surface3D | 3Dサーフェスチャートを表します |
| SurfaceWireframe3D | 3D ワイヤーフレーム 表面チャートを表します。 |
| SurfaceContour | 等高線チャートを表します |
| SurfaceContourWireframe | ワイヤーフレーム等高線チャートを表します |
| Bubble | バブルチャートを表します |
| Bubble3D | 3Dバブルチャートを表します |
| Cylinder | シリンダーチャートを表します |
| CylinderStacked | 積み上げシリンダーチャートを表します |
| Cylinder100PercentStacked | 100% 積み上げシリンダーチャートを表します |
| CylindricalBar | 円柱型棒グラフを表します。 |
| CylindricalBarStacked | 積み上げ円柱型棒グラフを表します。 |
| CylindricalBar100PercentStacked | 100% 積み上げ円柱型棒グラフを表します。 |
| CylindricalColumn3D | 3D 円柱型柱グラフを表します。 |
| Cone | 円錐チャートを表します |
| ConeStacked | 積み重ね円錐チャートを表します |
| Cone100PercentStacked | 100% 積み重ね円錐チャートを表します |
| ConicalBar | 円錐バーチャートを表します |
| ConicalBarStacked 積み重ね円錐バーチャートを表します | |
| ConicalBar100PercentStacked | 100% 積み重ね円錐バーチャートを表します |
| ConicalColumn3D | 3D円錐柱チャートを表します |
| Pyramid | ピラミッドチャートを表します |
| PyramidStacked | 積み重ねピラミッドチャートを表します |
| Pyramid100PercentStacked | 100% 積み重ねピラミッドチャートを表します |
| PyramidBar | ピラミッド棒グラフを表す |
| PyramidBarStacked | 積み重ねピラミッドバーチャートを表します |
| PyramidBar100PercentStacked | 100% 積み重ねピラミッドバーチャートを表します |
| PyramidColumn3D | 3Dピラミッド柱チャートを表します |
| Aspose.Cellsを使用してグラフを作成するには： |
- CellオブジェクトのsetValueメソッドを使用してワークシートセルにデータを追加します。 これはグラフのデータソースとして使用されます。
- ChartCollectionコレクションのaddメソッドを呼び出し、Worksheetオブジェクトにカプセル化されたワークシートにチャートを追加します。
- ChartType列挙型を使用してチャートのタイプを指定します。 たとえば、この例ではグラフの種類としてChartType.PYRAMID値を使用します。
- インデックスを渡してChartCollectionコレクションから新しいChartオブジェクトをアクセスします。
- Chartオブジェクトにカプセル化されたチャートの管理に使用できるいずれかのチャートオブジェクトを使用します。 以下の例では、SeriesCollectionチャートオブジェクトを使用して、チャートのデータソースを指定します。
チャートにソースデータを追加する場合、データソースはセルの範囲（“A1:C3"など）、非連続セルのシーケンス（“A1, A3, A5"など）、値のシーケンス（“1,2,3"など）のいずれかです。
これらの一般的な手順を使用すると、任意のタイプのチャートを作成できます。異なるチャートオブジェクトを使用して、異なるチャートを作成します。
例のコードを実行すると、以下に示すようにワークシートにピラミッドグラフが追加されます。
データソースを持つピラミッドグラフ
バブルチャートを作成するには、ChartTypeをChartType.BUBBLEに設定する必要があり、BubbleSizes、Values、およびXValuesなどのいくつかの追加プロパティを適切に設定する必要があります。次のコードを実行すると、以下に示すようにワークシートにバブルチャートが追加されます。
データソースを持つバブルチャート
データマーカー付きラインチャート
データマーカー付き折れ線グラフを作成するには、ChartTypeをChartType.LINE_WITH_DATA_MARKERSに設定し、背景エリア、シリーズマーカー、値、およびXValuesなどの追加プロパティを適切に設定する必要があります。次のコードを実行すると、以下に示すようにワークシートにデータマーカー付き折れ線グラフが追加されます。
カスタムチャートの作成
これまでに、標準のフォーマット設定を持つ標準のチャートを見てきました。データソースを定義し、いくつかのプロパティを設定すると、デフォルトのフォーマット設定でグラフが作成されます。しかし、Aspose.Cellsは開発者が独自のフォーマット設定でグラフを作成できるカスタムチャートもサポートしています。
カスタムチャートの作成
開発者は、Aspose.CellsのシンプルなAPIを使用して実行時にカスタムチャートを作成できます。
チャートはデータシリーズで構成されています。Aspose.Cellsの各データシリーズはSeriesオブジェクトで表され、SeriesCollectionオブジェクトはSeriesオブジェクトのコレクションとして機能します。カスタムチャートの作成時、開発者は異なるタイプのチャートを異なるデータシリーズ（SeriesCollectionオブジェクトで収集）に使用する自由があります。
以下の例コードは、カスタムチャートの作成方法を示しています。この例では、最初のデータ系列には列チャートを使用し、2番目のデータ系列には折れ線グラフを使用しています。その結果、ワークシートには列チャートと折れ線グラフが組み合わされたチャートが追加されます。
カラムとラインチャートを組み合わせたカスタムチャート
プログラミング例