Werk Met Kaarte

Nuwe insert_chart metode is bygevoeg in die DocumentBuilder klas. So, kom ons kyk hoe om’n eenvoudige kolom grafiek in die dokument te voeg met behulp van DocumentBuilder.insert_chart metode:

Hoe Om’n Grafiek In Te Voeg

In hierdie afdeling sal ons leer hoe om’n grafiek in’n dokument in te voeg.

Voeg Kolomgrafiek In

Die volgende kode voorbeeld toon hoe om kolom grafiek in te voeg:

Die kode lewer die volgende resultaat:

create-column-chart-aspose-words-net

Daar is add, add_double en add_date metodes, wat blootgestel is om alle moontlike variante van databronne vir alle grafiek tipes te dek:

Die kode lewer die volgende resultaat:

create-column-chart-from-datasource-aspose-words-net

Voeg By Verstrooiingskaart

Hieronder voorbeeld toon hoe om’n verstrooiing grafiek in te voeg.

Die kode lewer die volgende resultaat:

scatter-chart-aspose-words-net

Voeg By Area Grafiek

Die volgende kode voorbeeld toon hoe om’n area grafiek in te voeg:

Die kode lewer die volgende resultaat:

area-chart-aspose-words-net

Voeg By Borrelgrafiek

Die volgende kode voorbeeld toon hoe om’n borrel grafiek in te voeg:

Die kode lewer die volgende resultaat:

bubble-chart-aspose-words-net

Werk Met Kaarte deur Vorm.kaart Voorwerp

Sodra die grafiek ingevoeg en gevul is met data, kan u die voorkoms daarvan verander. Shape.chart eiendom bevat alle grafiek verwante opsies beskikbaar deur die publiek API.

Byvoorbeeld, kom ons verander Chart titel of legende gedrag:

Die kode genereer die volgende resultate:

line-chart-aspose-words-net

Hoe om te Werk met ChartSeriesCollection Van Grafiek

Kom ons kyk na ChartSeries versameling. Alle grafiekreekse is beskikbaar deur Chart.series versameling:

U kan reekse een vir een verwyder of almal skoonmaak, asook’n nuwe een byvoeg indien nodig. Die nuut ingevoegde grafiek het’n paar standaardreekse by hierdie versameling gevoeg. Om hulle te verwyder moet jy chart.series.clear() metode bel.

Werk Met Enkele ChartSeries Klas

Hier is hoe om met’n spesifieke reeks te werk.

Sien asseblief die resultaat hieronder:

line-chart-chartseries-aspose-words-net

Alle enkel ChartSeries het verstek ChartDataPoint opsies, probeer asseblief die volgende kode gebruik om hulle te verander:

Sien asseblief die resultaat hieronder:

line-chart-chartdatapoint-aspose-words-net

Hoe Om Te Werk met’n enkele ChartDataPoint van’n ChartSeries

Met behulp van ChartDataPoint kan u die opmaak van’n enkele datapunt van die grafiekreeks aanpas:

Sien asseblief die resultaat hieronder:

line-chart-datapoint-aspose-words-net

Hoe om te Werk met ChartDataLabel Van’n enkele ChartSeries

Gebruik ChartDataLabel jy in staat is om die formatering van’n enkele data etiket van die grafiek reeks spesifiseer, soos wys / verberg LegendKey, CategoryName, SeriesName, Waarde ens.

Sien asseblief die resultaat hieronder:

bar-chart-aspose-words-net

Hoe Om Te Definieer Verstek Opsies vir ChartDataLabels van ChartSeries

Die ChartDataLabelCollection klas definieer eienskappe wat gebruik kan word om standaard opsies vir ChartDataLabels vir Grafiek Reeks stel. Hierdie eienskappe sluit in:show_category_name, show_bubble_size, show_percentage, show_series_name, show_value en so aan.

Sien asseblief die resultaat hieronder:

pie-chart-aspose-words-net

Hoe Om Die Aantal Grafiekdata-Etikette Te Formateer

Met behulp van ChartDataLabel.number_format kan u die nommerformatering van’n enkele data-etiket van die grafiek spesifiseer.

Die volgende kode voorbeeld toon hoe om’n nommer van die data etiket te formateer:

Hoe Om Grafiek As Eienskappe Te Stel

As jy wil werk met grafiek as, skaal, en vertoon eenhede vir die waarde as, gebruik asseblief ChartAxis, AxisDisplayUnit, en AxisScaling klasse.

Die volgende kode voorbeeld toon hoe Om x en Y-as eienskappe te definieer:

Hoe Om Datum Tyd Waarde Van As Stel

Die volgende kode voorbeeld toon hoe om datum / tyd waardes te stel om as eienskappe:

Hoe Om Die Nommerwaarde Van Die As Te Formateer

Die volgende kode voorbeeld toon hoe om die formaat van getalle op die waarde as te verander:

Hoe Om Grense Van As Te Stel

Die AxisBound klas verteenwoordig’n minimum of maksimum grens van as waardes. Gebind kan gespesifiseer word as’n numeriese, datum-tyd of’n spesiale “outomatiese” waarde.

Die volgende kode voorbeeld toon hoe om grense van’n as stel:

Hoe Om Intervaleenheid Tussen Etikette Te Stel

Die volgende kode voorbeeld toon hoe om die interval eenheid tussen etikette op’n as stel:

Hoe Om Grafiek As Te Verberg

As jy die kaartas wil wys of wegsteek, kan jy dit eenvoudig bereik deur die waarde van ChartAxis.hidden eienskap in te stel.

Die volgende kode voorbeeld toon hoe om die Y-as van die grafiek te verberg:

Hoe Om Grafiek Etiket In Lyn Te Bring

As jy’n teks belyning vir multi-lyn etikette wil stel, kan jy dit eenvoudig bereik deur die waarde van ChartAxis.tick_label_alignment eiendom te stel.

Die volgende kode voorbeeld toon hoe om etiket belyning merk:

Hoe Om Vul En Beroerte Formatering Stel

Vul en slag formatering kan ingestel word vir grafiek reeks, data punte, en merkers. Om dit te doen, moet jy die eienskappe van die ChartFormat tipe in die ChartSeries, ChartDataPoint, en ChartMarker klasse gebruik, asook aliasse vir sommige eienskappe, soos fore_color, back_color, visible, en transparency in die Stroke klas.

Die volgende kode voorbeeld toon hoe om reeks kleur stel:

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

Die volgende kode voorbeeld toon hoe om lyn kleur en gewig stel:

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