Práce s grafy
Nový insertChart byla přidána do DocumentBuilder třída. Podívejme se, jak vložit jednoduchý sloupcový graf do dokumentu pomocí vložit Graf metoda.
Jak vložit graf ze Škrábance pomocí Aspose.Words
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:
Existují čtyři různé přetížení pro sérii Přidat metodu, která byla vystavena pokrytí všech možných variant zdrojů dat pro všechny typy grafů:
Kód produkuje následující výsledek:
Vložit rozptyl Graf
Následující příklad kódu 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 Předmět
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 grafem dostupné prostřednictvím veřejnosti API.
Například, pojďme změnit Titulek nebo legenda chování:
Kód generuje následující výsledky:
Jak pracovat s ChartSeriesSběr grafu
Podívejme se na to. ChartSeries kolekce. Všechny řady grafů jsou k dispozici prostřednictvím chart.getSeries() sběr, který je Iterable:
Můžete odstranit sérii jedna po jedné nebo vymazat všechny z nich, stejně jako přidat nový v případě potřeby. Nově vložená tabulka má k této kolekci přidány některé výchozí řady. Chcete-li odstranit, musíte zavolat graf.getSeries().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 samostatné ChartSeries mají výchozí ChartDataPoint možnosti, zkuste prosím použít následující kód pro jejich změnu:
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 grafDataLabel jedné řady grafů
Použití ChartDataLabel jste schopni určit formátování jednoho datového štítku série grafu, jako je show/hide LegendKey, CategoryName, SeriesName, Hodnota atd.:
Viz níže uvedený výsledek:
Jak definovat výchozí možnosti pro ChartDataLabels of ChartSeries
The ChartDataLabelCollection třída definuje vlastnosti, které lze použít pro nastavení výchozích možností ChartDataLabels pro graf Series. Tyto vlastnosti zahrnují setShowCategoryName, setShowBubbleSize, setShowProcentage, setShowSeriesName, setShowShow Hodnota atd.:
Viz níže uvedený výsledek:
Jak formátovat počet znaků
Použití NumberFormat vlastnost, můžete zadat číslo formátování 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ím a zobrazením jednotek pro osu hodnoty, 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
The AxisBound třída představuje minimální nebo maximální hranici hodnot osy. Hranice může být specifikována 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 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 setTickLabelAlignment() 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 je třeba použít vlastnosti ChartFormat type in the ChartSeries, ChartDataPoint, and ChartMarker class, jakož i aliasy pro některé vlastnosti, jako je ForeColor, BackColor, Visible, a transparentnost v Stroke třída.
Následující příklad kódu ukazuje, jak nastavit barvu série:
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");
Následující příklad kódu ukazuje, jak nastavit barvu řádku a hmotnost:
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");