Как работать с диаграммами в .NET

Шаг 1: Получить библиотеку

Клонируйте репозиторий и соберите Aspose.Words.sln в конфигурации Release, затем добавьте ссылку на проект Aspose.Words.csproj из вашего собственного проекта .NET, как описано в руководстве по установке.

Шаг 2: Вставить диаграмму и упростить её внешний вид

DocumentBuilder.InsertChart(chartType, width, height) вставляет форму диаграммы в позицию курсора и возвращает содержащий Shape; её свойство Chart — это объект Chart, который вы настраиваете, с AxisX, AxisY, Legend и Title в качестве основных под-объектов. Типы диаграмм находятся в пространстве имён Aspose.Words.Drawing.Charts рядом с ядром пространства имён Aspose.Words. Минимальная, готовая к презентации диаграмма ChartType.Bar в новом Document часто подразумевает установку Legend.Position в LegendPosition.None, установку Hidden и HasMajorGridlines на AxisY и AxisX, установку Title.Show в false, очистку заполнителя ChartSeriesCollection с помощью Series.Clear() перед вызовом Series.Add(seriesName, categories, values), фиксирование AxisY.Scaling.Maximum на заданном AxisBound вместо автоматического масштабирования, затем запись результата с помощью Document.Save. Полный пример — Document, DocumentBuilder, Chart, AxisX, AxisY, Legend, Title, ChartSeriesCollection, AxisBound и Document.Save — выглядит так:

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

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.InsertChart(ChartType.Bar, 432, 252);
Chart chart = shape.Chart;
chart.Legend.Position = LegendPosition.None;

ChartSeriesCollection seriesColl = chart.Series;
chart.AxisY.Hidden = true;
chart.AxisY.HasMajorGridlines = false;
chart.AxisX.Hidden = true;
chart.Title.Show = false;

seriesColl.Clear();
chart.AxisY.Scaling.Maximum = new AxisBound(100);

string[] categories = new string[] { "AW Category 1" };
seriesColl.Add("AW Series 1", categories, new double[] { 30 });

doc.Save("chart.docx");

Это создает Document, вставляет ChartType.Bar диаграмму, устанавливает Chart.Legend.Position в LegendPosition.None, чтобы скрыть легенду, устанавливает Hidden = true и HasMajorGridlines = false на chart.AxisY и Hidden = true на chart.AxisX, устанавливает chart.Title.Show = false, очищает серию заполнителя с помощью seriesColl.Clear(), фиксирует ось значений на максимум 100 через chart.AxisY.Scaling.Maximum = new AxisBound(100), добавляет одну реальную серию с seriesColl.Add(seriesName, categories, values) и записывает результат с Document.Save.

Шаг 3: Выберите другой тип диаграммы

ChartType охватывает стандартные семейства диаграмм Word — Line, Bar, Column (плюс варианты Stacked, PercentStacked и 3D), Pie, PieOfPie, Doughnut, Area, Scatter, Bubble, Radar, Stock, Surface, а также типы Word 2016 Treemap, Sunburst, Histogram, Pareto, BoxAndWhisker и Waterfall. Передайте нужное значение в качестве аргумента chartType функции InsertChart — нет члена, который меняет тип уже существующей диаграммы после вставки, поэтому выберите правильный тип заранее или замените shape.

Шаг 4: Добавьте и отформатируйте подписи данных

Установите series.HasDataLabels = true перед настройкой series.DataLabels (это ChartDataLabelCollection) — переключатели отображения не оказывают видимого эффекта, пока подписи выключены. ShowValue, ShowCategoryName и ShowPercentage управляют тем, какие сведения отображаются, а Position размещает их относительно точки данных.

Шаг 5: Форматирование отдельной точки данных

Обратитесь к DataPoints серии (это ChartDataPointCollection), чтобы достичь одной ChartDataPoint и задать её Format, Marker, Explosion или InvertIfNegative независимо от остальных элементов серии. Так вы выделяете отдельный столбец, сектор или маркер, не меняя стиль всей серии.