Wordレポートを生成するとき、チャートのプロット領域を文書全体に合わせて書式設定できます。プロット領域はチャートがデータを表示する場所です。これは、タイトルや凡例も含めることができる、より大きなチャート領域の内部に位置しています。

このチュートリアルでは、C# で列グラフを作成し、プロット領域にグラデーション塗りつぶしと枠線を適用し、グラフを Word 文書に保存する方法を示します。

C# ライブラリで Word チャートのプロット領域をフォーマットする

Aspose.Words for .NET は .NET アプリケーションで Word ドキュメントの作成と操作を可能にします。プロット領域の塗りつぶしと線の書式設定 API はバージョン 26.10 以降 で利用可能です。

プロジェクトにパッケージを追加するには、.NET CLI を使用します:

dotnet add package Aspose.Words --version 26.10.0

ライブラリは評価モードで使用するか、無料の一時ライセンスをリクエストして、評価制限なしで評価できます。

C# で Word チャートのプロット領域をフォーマットする

チャートを作成し、書式設定するには、次の手順に従ってください：

  1. Document と DocumentBuilder を作成します。
  2. InsertChart() を使用して縦棒グラフを挿入し、返されたシェイプからチャートにアクセスします。
  3. デフォルトの系列をクリアし、独自のカテゴリと値を追加します。
  4. Chart.PlotArea.Format にアクセスします。
  5. グラデーション塗りつぶしを適用し、枠線の色と幅を設定します。
  6. ドキュメントを DOCX ファイルとして保存します。

以下の完全な例は、2つの系列を持つチャートを作成し、そのプロット領域の書式設定を行います:

using System.Drawing;
using Aspose.Words;
using Aspose.Words.Drawing;
using Aspose.Words.Drawing.Charts;

class Program
{
    static void Main()
    {
        // Create a document and insert a column chart.
        Document doc = new Document();
        DocumentBuilder builder = new DocumentBuilder(doc);
        Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
        Chart chart = shape.Chart;

// Replace the default series with sample data.
        chart.Series.Clear();
        string[] categories = { "Quarter 1", "Quarter 2" };
        chart.Series.Add("2025", categories, new double[] { 1, 2 });
        chart.Series.Add("2026", categories, new double[] { 3, 4 });

// Set the plot-area fill and border.
        ChartPlotArea plotArea = chart.PlotArea;
        plotArea.Format.Fill.OneColorGradient(
            Color.LightBlue, GradientStyle.DiagonalUp,
            GradientVariant.Variant2, 1);
        plotArea.Format.Stroke.ForeColor = Color.Blue;
        plotArea.Format.Stroke.Weight = 0.25;

// Save the document.
        doc.Save("formatted-chart-csharp.docx");
    }
}

プロット領域の書式設定の仕組み

新しく挿入されたチャートには生成されたデータが含まれています。例では、そのシリーズをクリアし、同じ 2 つのカテゴリに対する値を持つ 2 つの新しいシリーズを追加します。

The Chart.PlotArea.Format プロパティは、プロット領域の塗りつぶしと線の書式設定にアクセスできます。 OneColorGradient() はグラデーションの色、スタイル、バリアント、度合いを設定します。 Stroke.ForeColor は枠線の色を設定し、Stroke.Weight はその幅を設定します。例では 0.25 ポイントが使用されています。

フォーマットされたチャートの表示

Word ドキュメントビューアで formatted-chart-csharp.docx を開きます。ドキュメントには 2 つのデータ系列を持つ縦棒グラフが含まれ、プロット領域はライトブルーのグラデーション、薄い青い枠線があります。データと書式設定の値をレポートに合わせて変更してください。

Wordチャートのプロット領域を書式設定する。

Wordチャートのプロット領域を書式設定する。

結論

C# を使用して Word の縦棒グラフを作成し、プロット領域をカスタマイズしました。独自のレポートでさまざまな色やデータを試し、さらに多くのチャート例については Word で C# を使用してチャートを作成する方法 をご覧ください。

参照