Werken met grafieken

Nieuw insert_chart de methode is toegevoegd aan de DocumentBuilder Klasse. Dus, laten we eens kijken hoe je een eenvoudige kolom grafiek in het document in te voegen met behulp van DocumentBuilder.insert_chart methode:

Hoe een grafiek in te voegen

In deze sectie zullen we leren hoe we een grafiek in een document kunnen plaatsen.

Kolomdiagram invoegen

Het volgende voorbeeld van code laat zien hoe kolomdiagram invoegen:

De code levert het volgende resultaat op:

Er zijn add, add_double en add_date methoden, die zijn blootgesteld aan alle mogelijke varianten van gegevensbronnen voor alle grafiektypes:

De code levert het volgende resultaat op:

Scatter invoegen Grafiek

Hieronder laat je zien hoe je een scatter grafiek invoegt.

De code levert het volgende resultaat op:

Gebied invoegen Grafiek

Het volgende voorbeeld van code laat zien hoe je een gebiedskaart invoegt:

De code levert het volgende resultaat op:

Bellendiagram invoegen

Het volgende voorbeeld van code laat zien hoe je een bubble grafiek invoegt:

De code levert het volgende resultaat op:

Werken met grafieken via Shape.chart Object

Zodra de grafiek werd ingevoegd en gevuld met gegevens, bent u in staat om zijn uiterlijk te veranderen. Shape.chart eigenschap bevat alle grafiek gerelateerde opties beschikbaar via het publiek API.

Bijvoorbeeld, laten we veranderen Chart titel of legende gedrag:

De code genereert de volgende resultaten:

Hoe te werken met ChartSeriesCollectie van Grafiek

Laten we kijken naar ChartSeries verzameling. Alle grafiek series zijn beschikbaar via Chart.series verzameling:

U kunt de serie één voor één verwijderen of ze allemaal wissen en indien nodig een nieuwe toevoegen. De nieuw ingevoegde grafiek heeft een aantal standaard series toegevoegd aan deze collectie. Om ze te verwijderen moet je bellen chart.series.clear() methode.

Werken met een enkele ChartSeries klasse

Hier is hoe te werken met een bepaalde serie.

Zie het onderstaande resultaat:

Allemaal single ChartSeries standaard ChartDataPoint opties, probeer de volgende code te wijzigen:

Zie het onderstaande resultaat:

Hoe te werken met Single ChartDataPoint van een ChartSeries

Gebruik ChartDataPoint je bent in staat om de opmaak van een enkel datapunt van de grafiek serie aan te passen:

Zie het onderstaande resultaat:

Hoe te werken met ChartDataLabel van een enkele Grafiekserie

Gebruik ChartDataLabel u in staat bent om de opmaak van een enkele gegevenslabel van de grafiek serie, zoals tonen/verbergen LegendKey, CategorieNaam, Serienaam, Waarde enz.

Zie het onderstaande resultaat:

Hoe de standaardopties voor ChartDataLabels van ChartSeries definiëren

De ChartDataLabelCollection klasse definieert eigenschappen die gebruikt kunnen worden voor het instellen van standaardopties voor ChartDataLabels voor Grafiek Series. Deze eigenschappen omvatten show_category_name, show_bubble_size, show_percentage, show_series_name, show_value enz.

Zie het onderstaande resultaat:

Hoe het aantal grafiekgegevens te formatteren

Gebruik ChartDataLabel.number_format u in staat bent om nummeropmaak van een enkel gegevenslabel van de grafiek te specificeren.

Het volgende voorbeeld van code laat zien hoe je een nummer van het gegevenslabel formatteert:

Eigenschappen van grafiekas instellen

Als u wilt werken met kaartas, schaalverdeling, en display units voor de waarde as, gebruik dan ChartAxis, AxisDisplayUnit, en AxisScaling lessen.

Het volgende voorbeeld van code laat zien hoe X- en Y-as eigenschappen te definiëren:

Hoe instellen Date Tijdswaarde van de as

Het volgende voorbeeld van code laat zien hoe u datum/tijdwaarden op aseigenschappen kunt instellen:

Hoe nummerwaarde van de as te formatteren

Het volgende voorbeeld van code laat zien hoe het formaat van de getallen op de waardeas kan worden gewijzigd:

Hoe de grenzen van de as instellen

De AxisBound klasse vertegenwoordigt een minimum- of maximumgrens aan aswaarden. Bound kan worden gespecificeerd als een numerieke, datum-tijd of een speciale “auto” waarde.

Het volgende codevoorbeeld laat zien hoe je grenzen van een as kunt instellen:

Hoe de Interval-eenheid tussen labels instellen

Het volgende codevoorbeeld laat zien hoe u de interval-eenheid tussen labels op een as kunt instellen:

Hoe kaartas te verbergen

Als u de kaartas wilt tonen of verbergen, kunt u dit eenvoudig bereiken door de waarde van ChartAxis.hidden eigendom.

Het volgende voorbeeld van code laat zien hoe de Y-as van de grafiek te verbergen:

Hoe kaartlabel uitlijnen

Als u een tekstuitlijning voor multi-line labels wilt instellen, kunt u dit gewoon bereiken door de waarde van ChartAxis.tick_label_alignment eigendom.

Het volgende voorbeeld van code laat zien hoe u label uitlijning aankruist:

MS Word richt het Chart-label standaard uit op het centrum.

Hoe vul en beroerde opmaak instellen

Vul en slag opmaak kan worden ingesteld voor grafiek serie, datapunten, en markers. Om dit te doen, moet u de eigenschappen van de ChartFormat type in de ChartSeries, ChartDataPoint, en ChartMarker klassen, evenals aliassen voor sommige eigenschappen, zoals fore_color, back_color, visible, en transparency in de Stroke Klasse.

Het volgende voorbeeld van code laat zien hoe seriekleur te instellen:

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")

Het volgende voorbeeld van code laat zien hoe je lijnkleur en gewicht kunt instellen:

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")