Werk Met Kaarte
Die nuwe insertChart metode is bygevoeg in die DocumentBuilder klas. So, kom ons kyk hoe om’n eenvoudige kolomgrafiek in die dokument in te voeg met behulp van insertChart metode.
Hoe Om’n Grafiek Van Nuuts Af In te Voeg met Aspose.Words
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:
Daar is vier verskillende oorladings vir die series Add metode, wat blootgestel is om alle moontlike variante van databronne vir alle grafiek tipes te dek:
Die kode lewer die volgende resultaat:
Voeg By Verstrooiingskaart
Die volgende kode voorbeeld toon hoe om’n verspreiding grafiek in te voeg:
Die kode lewer die volgende resultaat:
Voeg By Area Grafiek
Die volgende kode voorbeeld toon hoe om’n area grafiek in te voeg:
Die kode lewer die volgende resultaat:
Voeg By Borrelgrafiek
Die volgende kode voorbeeld toon hoe om’n borrel grafiek in te voeg:
Die kode lewer die volgende resultaat:
Werk Met Kaarte deur Shape.Chart
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 Grafiek titel of legende gedrag:
Die kode genereer die volgende resultate:
Hoe om te Werk met ChartSeriesCollection Van Grafiek
Kom ons kyk na ChartSeries versameling. Alle grafiekreekse is beskikbaar deur die chart.getSeries() - versameling, wat Iterableis:
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 die chart.getSeries().clear() - metode bel.
Werk Met Enkele ChartSeries Klas
Hier is hoe om met’n spesifieke reeks te werk.
Sien asseblief die resultaat hieronder:
Alle enkel ChartSeries het verstek ChartDataPoint opsies, probeer asseblief die volgende kode om hulle te verander:
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:
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:
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 Series te stel. Hierdie eienskappe sluit in:setShowCategoryName, setShowBubbleSize, setShowPercentage, setShowSeriesName, setShowValue ens:
Sien asseblief die resultaat hieronder:
Hoe Om Die Aantal Grafiekdata-Etikette Te Formateer
Deur die NumberFormat eienskap te gebruik, kan jy die getalformatering 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 DateTime Waarde Van As Te 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 die 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 setTickLabelAlignment() 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 ForeColor, BackColor, Sigbaar, en Deursigtigheid in die Stroke
klas.
Die volgende kode voorbeeld toon hoe om reeks kleur stel:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
Chart chart = shape.Chart;
ChartSeriesCollection seriesColl = chart.Series;
// Delete default generated series.
seriesColl.Clear();
// Create category names array.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };
// Adding new series. Value and category arrays must be the same size.
ChartSeries series1 = seriesColl.Add("AW Series 1", categories, new double[] { 1, 2 });
ChartSeries series2 = seriesColl.Add("AW Series 2", categories, new double[] { 3, 4 });
ChartSeries series3 = seriesColl.Add("AW Series 3", categories, new double[] { 5, 6 });
// Set series color.
series1.Format.Fill.ForeColor = Color.Red;
series2.Format.Fill.ForeColor = Color.Yellow;
series3.Format.Fill.ForeColor = Color.Blue;
doc.Save("ColumnColor.docx");
Die volgende kode voorbeeld toon hoe om lyn kleur en gewig stel:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
ChartSeriesCollection seriesColl = chart.Series;
// Delete default generated series.
seriesColl.Clear();
// Adding new series.
ChartSeries series1 = seriesColl.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });
ChartSeries series2 = seriesColl.Add("AW Series 2", new double[] { 0.5, 1.5, 2.5 }, new double[] { 3, 1, 2 });
// Set series color.
series1.Format.Stroke.ForeColor = Color.Red;
series1.Format.Stroke.Weight = 5;
series2.Format.Stroke.ForeColor = Color.LightGreen;
series2.Format.Stroke.Weight = 5;
doc.Save("LineColorAndWeight.docx");