Работа с диаграммами

Новый insert_chart Метод был добавлен в DocumentBuilder класс. Итак, давайте посмотрим, как вставить простую таблицу столбцов в документ с помощью DocumentBuilder.insert_chart метод:

Как вставить карту

В этом разделе мы узнаем, как вставить карту в документ.

Включить диаграмму колонок

Следующий пример кода показывает, как вставить столбцовую диаграмму:

Код дает следующий результат:

Существуют add, add_double и add_date Методы, которые были подвергнуты воздействию, охватывают все возможные варианты источников данных для всех типов диаграмм:

Код дает следующий результат:

Включить рассеяние Чарт

Ниже пример показывает, как вставить диаграмму рассеяния.

Код дает следующий результат:

Включить зону Чарт

Следующий пример кода показывает, как вставить диаграмму области:

Код дает следующий результат:

Включить Bubble Chart

Следующий пример кода показывает, как вставить пузырьковую диаграмму:

Код дает следующий результат:

Работа с графиками через Shape.chart Object

После того, как график был вставлен и заполнен данными, вы можете изменить его внешний вид. Shape.chart собственность содержит все варианты, связанные с диаграммами, доступные через общественность API.

Например, давайте изменим Chart Заголовок или поведение легенды:

Код генерирует следующие результаты:

Как работать с ChartSeriesСборник диаграмм

Давайте посмотрим на ChartSeries Коллекция. Все серии карт доступны через Chart.series коллекция:

Вы можете удалить серию по одной или очистить все из них, а также добавить новую, если это необходимо. Недавно вставленный график имеет некоторые серии по умолчанию, добавленные в эту коллекцию. Чтобы удалить их, вам нужно позвонить chart.series.clear() метод.

Работа с Single ChartSeries Class

Вот как работать с определенной серией.

Пожалуйста, смотрите результат ниже:

Все одинокие ChartSeries иметь дефолт ChartDataPoint Пожалуйста, попробуйте использовать следующий код, чтобы изменить их:

Пожалуйста, смотрите результат ниже:

Как работать с Single ChartDataPoint ChartSeries

Использовать ChartDataPoint Вы можете настроить форматирование одной точки данных серии диаграмм:

Пожалуйста, смотрите результат ниже:

Как работать с ChartDataLabel одной серии

Использовать ChartDataLabel Вы можете указать форматирование одной метки данных серии диаграмм, такой как show/hide LegendKey, CategoryName, SeriesName, Value и т.д.

Пожалуйста, смотрите результат ниже:

Как определить параметры по умолчанию для ChartDataLabels ChartSeries

The ChartDataLabelCollection класс определяет свойства, которые могут использоваться для установки опций по умолчанию для ChartDataLabels Серия карт. Эти свойства включают show_category_name, show_bubble_size, show_percentage, show_series_name, show_value и т.д.

Пожалуйста, смотрите результат ниже:

Как форматировать номер таблички с данными

Использовать ChartDataLabel.number_format Вы можете указать форматирование номера одной метки данных диаграммы.

Следующий пример кода показывает, как форматировать номер метки данных:

Как установить свойства Chart Axis

Если вы хотите работать с осью диаграмм, масштабированием и отображением блоков для оси значений, пожалуйста, используйте ChartAxis, AxisDisplayUnit, и AxisScaling классы.

Следующий пример кода показывает, как определить свойства оси X и Y:

Как установить Date Временное значение оси

Следующий пример кода показывает, как установить значения даты/времени на свойства оси:

Как определить значение числа оси

Следующий пример кода показывает, как изменить формат чисел на оси значений:

Как установить границы оси

The AxisBound Класс представляет собой минимальный или максимальный предел значений оси. Связь может быть указана как цифровое, дата-время или специальное “авто” значение.

Следующий пример кода показывает, как установить границы оси:

Как установить интервал между ярлыками

Следующий пример кода показывает, как установить интервал между ярлыками на оси:

Как скрыть ось диаграммы

Если вы хотите показать или скрыть ось диаграммы, вы можете просто достичь этого, установив значение ChartAxis.hidden собственность.

Следующий пример кода показывает, как скрыть Y-ось диаграммы:

Как выровнять Chart Label

Если вы хотите установить текстовое выравнивание для многострочных меток, вы можете просто достичь этого, установив значение ChartAxis.tick_label_alignment собственность.

Следующий пример кода показывает, как выравнивать этикетку:

MS Word по умолчанию выравнивает Chart Label в центр.

Как установить наполнение и форматирование инсульта

Форматирование заполнения и хода может быть установлено для серий диаграмм, точек данных и маркеров. Для этого нужно использовать свойства ChartFormat тип в котором ChartSeries, ChartDataPoint, и ChartMarker классы, а также псевдонимы для некоторых свойств, таких как fore_color, back_color, visible, и transparency в Stroke класс.

Следующий пример кода показывает, как установить цвет серии:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

shape = builder.insert_chart(aw.drawing.charts.ChartType.COLUMN, 432, 252)

chart = shape.chart
seriesColl = chart.series

# Delete default generated series.
seriesColl.clear()

# Create category names array.
categories = [ "AW Category 1", "AW Category 2" ]

# Adding new series. Value and category arrays must be the same size.
series1 = seriesColl.add("AW Series 1", categories, [ 1, 2 ])
series2 = seriesColl.add("AW Series 2", categories, [ 3, 4 ])
series3 = seriesColl.add("AW Series 3", categories, [ 5, 6 ])

# Set series color.
series1.format.fill.fore_color = drawing.Color.red
series2.format.fill.fore_color = drawing.Color.yellow
series3.format.fill.fore_color = drawing.Color.blue

doc.save(docs_base.artifacts_dir + "WorkingWithCharts.set_series_color.docx")

Следующий пример кода показывает, как установить цвет линии и вес:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

shape = builder.insert_chart(aw.drawing.charts.ChartType.LINE, 432, 252)

chart = shape.chart
seriesColl = chart.series

# Delete default generated series.
seriesColl.clear()

# Adding new series.
series1 = seriesColl.add_double("AW Series 1", [ 0.7, 1.8, 2.6 ], [ 2.7, 3.2, 0.8 ])
series2 = seriesColl.add_double("AW Series 2", [ 0.5, 1.5, 2.5 ], [ 3, 1, 2 ])

# Set series color.
series1.format.stroke.fore_color = drawing.Color.red
series1.format.stroke.weight = 5
series2.format.stroke.fore_color = drawing.Color.light_green
series2.format.stroke.weight = 5

doc.save(docs_base.artifacts_dir + "WorkingWithCharts.line_color_and_weight.docx")