当您生成 Word 报告时，您可以格式化图表的绘图区域，以补充文档的其余部分。绘图区域是图表显示数据的地方。它位于更大的图表区域内部，图表区域还可以包含标题和图例。

本教程向您展示如何在 C# 中创建柱形图，向其绘图区域应用渐变填充和边框，并将图表保存到 Word 文档中。

C# 库用于格式化 Word 图表绘图区域

Aspose.Words for .NET 让您在 .NET 应用程序中创建和处理 Word 文档。绘图区域填充和线条格式化 API 在版本 26.10 或更高 中可用。

使用 .NET CLI 将包添加到项目中：

dotnet add package Aspise.Words --version 26.10.0

您可以在评估模式下使用该库，或请求一个免费临时许可证来评估它而不受评估限制。

在 C# 中格式化 Word 图表的绘图区域

按照以下步骤创建和格式化图表：

  1. 创建一个 Document 和一个 DocumentBuilder。
  2. 使用 InsertChart() 插入柱状图，并通过返回的 shape 访问图表。
  3. 清除默认系列并添加您自己的类别和数值。
  4. 访问 Chart.PlotArea.Format。
  5. 应用渐变填充并设置边框颜色和宽度。
  6. 将文档保存为 DOCX 文件。

以下完整示例创建了一个包含两个系列的图表，并格式化其绘图区域：

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");
    }
}

绘图区域格式设置的工作原理

新插入的图表包含生成的数据。示例清除其系列并添加两个新系列，为相同的两个类别提供值。

Chart.PlotArea.Format 属性提供对绘图区域的填充和线条格式的访问。OneColorGradient() 设置渐变颜色、样式、变体和程度。Stroke.ForeColor 设置边框颜色，而 Stroke.Weight 设置其宽度；示例使用 0.25 磅。

查看已格式化的图表

在 Word 文档查看器中打开 formatted-chart-csharp.docx。该文档包含一个具有两个数据系列的柱形图，绘图区域有淡蓝色渐变，且有细蓝色边框。更改数据和格式值以匹配您的报告。

格式化 Word 图表的绘图区域。

格式化 Word 图表的绘图区域。

结论

您已经使用 C# 创建了 Word 柱状图并自定义了其绘图区域。尝试在自己的报告中使用不同的颜色和数据，并查看如何使用 C# 在 Word 中创建图表以获取更多图表示例。

另见