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