Работа с графики

Нов insert_chart метод е добавен в DocumentBuilder Клас. И така, нека видим как да вмъкнем проста колона в документа, използвайки DocumentBuilder.insert_chart метод:

Как да въведете диаграма

В този раздел ще се научим как да вкараме диаграма в документ.

Вмъкване на колона

Следният пример за код показва как да се вмъкне колона диаграма:

Кодът дава следния резултат:

Има. add, add_double както и add_date методи, които са били изложени на всички възможни варианти на източници на данни за всички видове карти:

Кодът дава следния резултат:

Вмъкване на скатер Графика

По-долу пример показва как да се вмъкне скатер диаграма.

Кодът дава следния резултат:

Вмъкване на зона Графика

Следният пример с код показва как да се постави диаграма на областта:

Кодът дава следния резултат:

Вмъкване на таблицата с мехурчета

Следният пример за код показва как да се вмъкне диаграма балон:

Кодът дава следния резултат:

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

След като диаграмата е поставена и изпълнена с данни, вие сте в състояние да промени външния си вид. Shape.chart имотът съдържа всички опции, свързани с графиката, достъпни чрез обществеността API.

Например, нека се променим. Chart заглавието или легендарното поведение:

Кодът генерира следните резултати:

Как да работите с ChartSeriesCollection of Chart

Нека да погледнем в ChartSeries Колекция. Всички серии карти са достъпни чрез Chart.series събиране:

Можете да премахнете серия една по една или да изчистите всички от тях, както и да добавите нова, ако е необходимо. Нововградената диаграма има някои добавени серии по подразбиране към тази колекция. За да ги премахнете, трябва да се обадите. chart.series.clear() метод.

Работа с единни карти клас

Ето как се работи с определена серия.

Моля, вижте резултата по-долу:

Всички необвързани ChartSeries е по подразбиране ChartDataPoint опции, моля опитайте се да използвате следния код, за да ги промените:

Моля, вижте резултата по-долу:

Как да работите с единична графикаDataPoint на a ChartSeries

Използване ChartDataPoint Вие сте в състояние да персонализирате форматирането на една точка от данните на серията диаграма:

Моля, вижте резултата по-долу:

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

Използване ChartDataLabel Вие сте в състояние да посочи форматирането на един етикет на данните от серията диаграма, като шоу / скрий ЛегендаКлюч, Категория Име, Серия Име, Стойност и др.

Моля, вижте резултата по-долу:

Как да определите настройките по подразбиране за ChartDataLabels на ChartSeries

На ChartDataLabelCollection клас определя свойства, които могат да бъдат използвани за задаване на опции по подразбиране за ChartDataLabels за Chart Series. Тези свойства включват show_category_name, show_bubble_size, show_percentage, show_series_name, show_value и т.н.

Моля, вижте резултата по-долу:

Как да форматираме номер на табелката с данните

Използване ChartDataLabel.number_format Вие сте в състояние да посочи номер форматиране на един етикет данни на диаграмата.

Следният пример за код показва как да се форматира редица от етикета на данните:

Как да зададете свойства на оста на диаграмата

Ако искате да работите с графика ос, мащабиране, и дисплей единици за стойността ос, моля, използвайте ChartAxis, AxisDisplayUnit, както и AxisScaling Класове.

Следният пример за код показва как да се определят свойствата на оста X и Y:

Как да зададете Date Времева стойност на оста

Следният пример за код показва как да се определят стойностите на дата/времето на осовите свойства:

Как да форматираме стойността на числото на оста

Следният пример за код показва как да се промени формата на числата по оста на стойността:

Как да се определят границите на оста

На AxisBound класът представлява минимална или максимална граница на осите. Облигацията може да бъде посочена като цифрова, дата или специална стойност на “автоматично.”

Следният пример за код показва как да се определят границите на оста:

Как да зададете интервал между етикетите

Следният пример за код показва как да се зададе интервалната единица между етикетите по оста:

Как да скрием оста на графиката

Ако искате да покажете или скриете оста на диаграмата, можете просто да постигнете това чрез определяне на стойността на ChartAxis.hidden собственост.

Следният пример за код показва как да се скрие оста Y на диаграмата:

Как да се подравнява етикет диаграма

Ако искате да зададете подравняване на текст за многолинейни етикети, можете просто да постигнете това чрез определяне на стойността на 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")