create-charts-in-word-documents-using-csharp

C#開発者は、プログラムでさまざまな種類のグラフをWord文書に挿入できます。データと情報をグラフィカルに表示するのに役立ちます。この記事では、C#を使用してWord文書でグラフを作成する方法を学習します。

この記事では、次のトピックについて説明/取り上げています。

Word文書にグラフを挿入するためのC#API

DOCXファイルにグラフを挿入するには、Aspose.Words for .NETAPIを使用します。クロスプラットフォームアプリケーション内でMicrosoftWordを直接利用せずに、ファイルを生成、変更、変換、レンダリング、および印刷できます。 APIを使用すると、さまざまなサポートされているグラフの種類をプログラムでWord文書に挿入できます。

APIのDLLをダウンロードするか、NuGetを使用してインストールできます。

Install-Package Aspose.Words

Word文書で縦棒グラフを作成する

以下の手順に従って、プログラムでWord文書に縦棒グラフを作成できます。

  • まず、Documentクラスを使用して新しいドキュメントを作成します。
  • 次に、Documentクラスオブジェクトを使用してDocumentBuilderクラスのインスタンスを作成します。
  • 次に、DocumentBuilder.InsertChart()メソッドを呼び出します。 ChartTypeを列として渡し、高さと幅を入力パラメーターとして渡します。
  • Shapeクラスオブジェクトで結果を取得します。
  • 次に、Chartクラスのインスタンスを作成し、それにShape.Chartオブジェクトを割り当てます。この図形にグラフがある場合は、グラフのプロパティにアクセスできます。
  • 次に、ChartSeriesCollectionオブジェクトでチャートシリーズコレクションを取得します。
  • カテゴリ名の配列を作成します。
  • 次に、ChartSeriesCollection.Add()メソッドを呼び出して、チャートシリーズを追加します。名前、カテゴリ配列、値を入力パラメータとして渡します。この手順を繰り返して、シリーズを追加します。
  • 最後に、出力ファイルパスを指定してDocument.Save()メソッドを呼び出し、ファイルを保存します。

次のコードサンプルは、C#を使用してWord文書に縦棒グラフを作成する方法を示しています。

// ドキュメントを作成する
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// デフォルトデータでチャートを追加します。さまざまなグラフの種類とサイズを指定できます。
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);

// ShapeのChartプロパティには、チャートに関連するすべてのオプションが含まれています。
Chart chart = shape.Chart;

// チャートシリーズコレクションを入手してください。
ChartSeriesCollection seriesColl = chart.Series;
// シリーズ数を確認してください。
Console.WriteLine(seriesColl.Count);

// デフォルトで生成されたシリーズを削除します。
seriesColl.Clear();

// カテゴリ名の配列を作成します。この例では、2つのカテゴリがあります。
string[] categories = new string[] { "AW Category 1", "AW Category 2" };

// 新しいシリーズを追加します。データ配列は空であってはならず、配列は同じサイズでなければならないことに注意してください。
seriesColl.Add("AW Series 1", categories, new double[] { 1, 2 });
seriesColl.Add("AW Series 2", categories, new double[] { 3, 4 });
seriesColl.Add("AW Series 3", categories, new double[] { 5, 6 });
seriesColl.Add("AW Series 4", categories, new double[] { 7, 8 });
seriesColl.Add("AW Series 5", categories, new double[] { 9, 10 });

// ドキュメントを保存する
doc.Save(@"C:\Files\Words\ColumnsChart.docx");
C#を使用してWord文書に縦棒グラフを作成します。

C#を使用してWord文書に縦棒グラフを作成する

C#を使用してWord文書に散布図を作成する

前述の手順に従って、プログラムで散布図をWord文書に挿入できます。ただし、DocumentBuilder.InsertChart()メソッドでChartType.Scatterを設定する必要があります。

次のコードサンプルは、C#を使用してWord文書に散布図を作成する方法を示しています。

// 新しいドキュメントを作成する
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// 散布図を挿入します。
Shape shape = builder.InsertChart(ChartType.Scatter, 432, 252);
Chart chart = shape.Chart;

// このオーバーロードを使用して、任意のタイプの散布図に系列を追加します。
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });

// ドキュメントを保存する
doc.Save(@"C:\Files\Words\ScatterChart.docx");
C#を使用してWord文書に散布図を作成します。

C#を使用してWord文書に散布図を作成する

C#を使用してWord文書に面グラフを挿入する

前述の手順に従って、プログラムで面グラフをWord文書に挿入できます。ただし、DocumentBuilder.InsertChart()メソッドでChartType.Areaを設定する必要があります。

次のコードサンプルは、C#を使用してWord文書に面グラフを作成する方法を示しています。

// 新しいドキュメントを作成する
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// 面グラフを挿入します。
Shape shape = builder.InsertChart(ChartType.Area, 432, 252);
Chart chart = shape.Chart;

// このオーバーロードを使用して、任意のタイプのエリア、レーダー、および株価チャートにシリーズを追加します。
chart.Series.Add("AW Series 1", new DateTime[] {
    new DateTime(2002, 05, 01),
    new DateTime(2002, 06, 01),
    new DateTime(2002, 07, 01),
    new DateTime(2002, 08, 01),
    new DateTime(2002, 09, 01)},
    new double[] { 32, 32, 28, 12, 15 });

// ドキュメントを保存する
doc.Save(@"C:\Files\Words\AreaChart.docx");
C#を使用してWord文書に面グラフを挿入します。

C#を使用してWord文書に面グラフを挿入する

C#を使用してWord文書にバブルチャートを挿入する

前述の手順に従って、プログラムでWord文書にバブルチャートを挿入できます。ただし、DocumentBuilder.InsertChart()メソッドでChartType.Bubbleを設定する必要があります。

次のコードサンプルは、C#を使用してWord文書にバブルチャートを作成する方法を示しています。

// 新しいドキュメントを作成する
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

// バブルチャートを挿入します。
Shape shape = builder.InsertChart(ChartType.Bubble, 432, 252);
Chart chart = shape.Chart;

// このオーバーロードを使用して、任意のタイプのバブルチャートにシリーズを追加します。
chart.Series.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 }, new double[] { 10, 4, 8 });

// ドキュメントを保存する
doc.Save(@"C:\Files\Words\BubbleChart.docx");
C#を使用してWord文書にバブルチャートを挿入します。

C#を使用してWord文書にバブルチャートを挿入する

無料ライセンスを取得する

無料の一時ライセンスをリクエストすることで、評価の制限なしにAPIを試すことができます。

結論

この記事では、C#を使用してWord文書でグラフを作成する方法を学びました。特に、Word文書で縦棒、面積、バブル、散布図をプログラムで作成する方法を学びました。同様に、他の種類のグラフを作成できます。 ドキュメントを使用して、Aspose.Words for.NETAPIの詳細を確認できます。ご不明な点がございましたら、フォーラムまでお気軽にお問い合わせください。

関連項目