Práce s grafy

Nový InsertChart metoda byla přidána do DocumentBuilder třída. Podívejme se, jak vložit jednoduchý sloupcový graf do dokumentu pomocí InsertChart 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:

create-column-chart-aspose-words-net

Existují čtyři různé přetížení pro série 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:

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

Vložit rozptýlit Graf

Následující příklad kódu ukazuje, jak vložit graf Scatter:

Kód produkuje následující výsledek:

scatter-chart-aspose-words-net

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:

area-chart-aspose-words-net

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:

bubble-chart-aspose-words-net

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 mapou dostupné prostřednictvím veřejnosti API.

Například, pojďme změnit Titulek grafu nebo legendární chování:

Kód generuje následující výsledky:

line-chart-aspose-words-net

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, který je IEnumerable:

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 graf.Series.Clear() metoda.

Práce s jednou třídou grafů

Zde je, jak pracovat s konkrétní sérii:

Viz níže uvedený výsledek:

line-chart-chartseries-aspose-words-net

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:

line-chart-chartdatapoint-aspose-words-net

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:

line-chart-datapoint-aspose-words-net

Jak pracovat s ChartDataLabel 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:

bar-chart-aspose-words-net

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 graf Series. Tyto vlastnosti zahrnují ShowCategoryName, ShowBubbleSize, ShowProcentage, ShowSeriesName, Show Hodnota atd.:

Viz níže uvedený výsledek:

pie-chart-aspose-words-net

Jak formátovat počet znaků

Použití NumberFormat 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 TickLabels.Zarovnání 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 ForeColor, BackColor, Viditelné, 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(dir + "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(dir + "LineColorAndWeight.docx");