Когда вы создаёте отчёт Word, вы можете отформатировать область построения диаграммы, чтобы она гармонировала с остальной частью документа. Область построения — это место, где диаграмма отображает свои данные. Она находится внутри более крупной области диаграммы, которая также может содержать заголовок и легенду.

В этом руководстве показано, как создать столбчатую диаграмму на C#, применить градиентную заливку и границу к области построения, а также сохранить диаграмму в документе Word.

Библиотека C# для форматирования области построения графика Word

Aspose.Words for .NET позволяет создавать и работать с документами Word в приложениях .NET. API заполнения области построения и форматирования линий доступен в версии 26.10 или новее.

Добавьте пакет в ваш проект, используя .NET CLI:

dotnet add package Aspose.Words --version 26.10.0

Вы можете использовать библиотеку в режиме оценки или запросить бесплатную временную лицензию, чтобы оценить её без ограничений оценки.

Форматирование области построения диаграммы Word на C#

Выполните следующие шаги, чтобы создать и отформатировать диаграмму:

  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 пункта.

Просмотр отформатированной диаграммы

Откройте formatted-chart-csharp.docx в просмотрщике документов Word. Документ содержит столбчатую диаграмму с двумя рядами данных, градиент светло‑голубого цвета в области построения и тонкую синюю границу. Измените данные и значения форматирования, чтобы они соответствовали вашему отчёту.

Форматировать область построения диаграммы Word.

Форматировать область построения диаграммы Word.

Заключение

Вы создали столбчатую диаграмму Word и настроили её область построения с помощью C#. Попробуйте разные цвета и данные в своих отчётах и посмотрите как создавать диаграммы в Word с использованием C# для получения дополнительных примеров диаграмм.

Смотрите также