Коли ви створюєте звіт 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# для отримання більшої кількості прикладів діаграм.

Дивіться також