Práce s grafy
Nový insert_chart metoda byla přidána do DocumentBuilder třída. Podívejme se, jak vložit jednoduchý sloupcový graf do dokumentu pomocí DocumentBuilder.insert_chart metoda:
Jak vložit graf
V této části se naučíme, jak vložit graf do dokumentu.
Vložit graf sloupce
Následující příklad kódu ukazuje, jak vložit sloupec graf:
Kód produkuje následující výsledek:
Jsou. add, add_double a add_date metody, které byly vystaveny pokrytí všech možných variant zdrojů dat pro všechny typy grafů:
Kód produkuje následující výsledek:
Vložit rozptýlit Graf
Níže uvedený příklad ukazuje, jak vložit graf Scatter.
Kód produkuje následující výsledek:
Vložit oblast Graf
Následující příklad kódu ukazuje, jak vložit graf plochy:
Kód produkuje následující výsledek:
Vložit graf bubliny
Následující příklad kódu ukazuje, jak vložit bublinový graf:
Kód produkuje následující výsledek:
Práce s grafy přes Shape.chart objekt
Jakmile byl graf vložen a vyplněn daty, jste schopni změnit jeho vzhled. Shape.chart vlastnost obsahuje všechny možnosti související s mapou dostupné prostřednictvím veřejnosti API.
Například, pojďme změnit Chart chování názvu nebo legendy:
Kód generuje následující výsledky:
Jak pracovat s ChartSeriesShromažďování grafu
Podívejme se na to. ChartSeries kolekce. Všechny řady grafů jsou k dispozici přes Chart.series sběr:
Můžete odstranit sérii jeden po druhém nebo vymazat všechny z nich, stejně jako přidat nový v případě potřeby. Nově vložený graf má k této kolekci přidánu defaultní řadu. Chcete-li odstranit, musíte zavolat chart.series.clear() metoda.
Práce s jednou třídou grafů
Zde je, jak pracovat s konkrétní série.
Viz níže uvedený výsledek:
Všechny nezadané ChartSeries mít výchozí ChartDataPoint možnosti, zkuste prosím pomocí následujícího kódu změnit:
Viz níže uvedený výsledek:
Jak pracovat s jedním grafDataPoint ChartSeries
Použití ChartDataPoint jste schopni přizpůsobit formátování jednoho datového bodu řady grafu:
Viz níže uvedený výsledek:
Jak pracovat s ChartDataLabel jedné řady grafů
Použití ChartDataLabel jste schopni určit formátování jednoho datového štítku řady grafu, jako je show/hide LegendKey, CategoryName, SeriesName, Value etc.
Viz níže uvedený výsledek:
Jak definovat výchozí možnosti pro grafDataLabels of ChartSeries
• ChartDataLabelCollection třída definuje vlastnosti, které lze použít pro nastavení výchozích možností ChartDataLabels pro Chart Series. Tyto vlastnosti zahrnují show_category_name, show_bubble_size, show_percentage, show_series_name, show_value atd.
Viz níže uvedený výsledek:
Jak formátovat počet znaků
Použití ChartDataLabel.number_format jste schopni určit formátování čísel jednoho datového štítku grafu.
Následující příklad kódu ukazuje, jak formátovat číslo štítku:
Jak nastavit vlastnosti grafu Osa
Pokud chcete pracovat s osou grafu, škálování a zobrazování jednotek pro hodnotovou osu, použijte prosím ChartAxis, AxisDisplayUnit, a AxisScaling třídy.
Následující příklad kódu ukazuje, jak definovat vlastnosti osy X a Y:
Jak nastavit Date Časová hodnota osy
Následující příklad kódu ukazuje, jak nastavit hodnoty datumu a času na vlastnosti osy:
Jak formátovat hodnotu čísla osy
Následující příklad kódu ukazuje, jak změnit formát čísel na ose hodnoty:
Jak nastavit hranice osy
• AxisBound třída představuje minimální nebo maximální hranici hodnot osy. Hranice může být uvedena jako numerická, data-time nebo speciální “auto” hodnota.
Následující příklad kódu ukazuje, jak nastavit hranice osy:
Jak nastavit mezi značkami mezilehlou jednotku
Následující příklad kódu ukazuje, jak nastavit intervalovou jednotku mezi štítky na osu:
Jak skrýt grafovou osu
Pokud chcete zobrazit nebo skrýt osu grafu, můžete toho jednoduše dosáhnout nastavením hodnoty ChartAxis.hidden majetek.
Následující příklad kódu ukazuje, jak skrýt osu Y grafu:
Jak zarovnat štítek grafu
Pokud chcete nastavit nastavení textu pro víceřádkové etikety, můžete toho jednoduše dosáhnout nastavením hodnoty ChartAxis.tick_label_alignment majetek.
Následující příklad kódu ukazuje, jak zaškrtnout zarovnání štítků:
Jak nastavit formátování fill a mrtvice
Formátování výplně a zdvihu lze nastavit pro grafové řady, datové body a značky. K tomu musíte použít vlastnosti ChartFormat typ ChartSeries, ChartDataPoint, a ChartMarker třídy, jakož i aliasy pro některé vlastnosti, jako jsou fore_color, back_color, visible, a transparency v Stroke třída.
Následující příklad kódu ukazuje, jak nastavit barvu série:
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")Následující příklad kódu ukazuje, jak nastavit barvu řádku a hmotnost:
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")