Jak pracovat s grafy v .NET

Krok 1: Získání knihovny

Naklonujte repozitář a sestavte Aspose.Words.sln v konfiguraci Release, poté přidejte odkaz na projekt Aspose.Words.csproj z vašeho vlastního projektu .NET, jak je popsáno v průvodci instalací.

Krok 2: Vložení grafu a zjednodušení jeho vzhledu

DocumentBuilder.InsertChart(chartType, width, height) vloží tvar grafu na pozici kurzoru a vrátí obsahující Shape; jeho vlastnost Chart je objekt Chart, který konfigurujete, s AxisX, AxisY, Legend a Title jako hlavními podobjekty. Typy grafů jsou umístěny v jmenném prostoru Aspose.Words.Drawing.Charts vedle jádrového jmenného prostoru Aspose.Words. Minimální, prezentaci připravený ChartType.Bar graf na novém Document často znamená nastavení Legend.Position na LegendPosition.None, nastavení Hidden a HasMajorGridlines na AxisY a AxisX, nastavení Title.Show na false, vymazání zástupného ChartSeriesCollection pomocí Series.Clear() před voláním Series.Add(seriesName, categories, values), přiřazení AxisY.Scaling.Maximum k pevné AxisBound místo automatického škálování, a poté zápis výsledku pomocí Document.Save. Kompletní příklad — Document, DocumentBuilder, Chart, AxisX, AxisY, Legend, Title, ChartSeriesCollection, AxisBound a Document.Save — vypadá takto:

using Aspose.Words;
using Aspose.Words.Drawing.Charts;

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Shape shape = builder.InsertChart(ChartType.Bar, 432, 252);
Chart chart = shape.Chart;
chart.Legend.Position = LegendPosition.None;

ChartSeriesCollection seriesColl = chart.Series;
chart.AxisY.Hidden = true;
chart.AxisY.HasMajorGridlines = false;
chart.AxisX.Hidden = true;
chart.Title.Show = false;

seriesColl.Clear();
chart.AxisY.Scaling.Maximum = new AxisBound(100);

string[] categories = new string[] { "AW Category 1" };
seriesColl.Add("AW Series 1", categories, new double[] { 30 });

doc.Save("chart.docx");

Toto vytvoří Document, vloží ChartType.Bar graf, nastaví Chart.Legend.Position na LegendPosition.None pro skrytí legendy, nastaví Hidden = true a HasMajorGridlines = false na chart.AxisY a Hidden = true na chart.AxisX, nastaví chart.Title.Show = false, vymaže zástupnou sérii pomocí seriesColl.Clear(), pevně nastaví hodnotovou osu na maximum 100 pomocí chart.AxisY.Scaling.Maximum = new AxisBound(100), přidá jednu skutečnou sérii pomocí seriesColl.Add(seriesName, categories, values) a zapíše výsledek pomocí Document.Save.

Krok 3: Vyberte jiný typ grafu

ChartType pokrývá standardní rodiny grafů Wordu — Line, Bar, Column (plus varianty Stacked, PercentStacked a 3D), Pie, PieOfPie, Doughnut, Area, Scatter, Bubble, Radar, Stock, Surface a typy Word 2016 Treemap, Sunburst, Histogram, Pareto, BoxAndWhisker a Waterfall. Předávejte požadovanou hodnotu jako argument chartType pro InsertChart — neexistuje žádný člen, který by po vložení měnil typ existujícího grafu, takže vyberte ten správný předem nebo nahraďte tvar.

Krok 4: Přidejte a formátujte popisky dat

Nastavte series.HasDataLabels = true před konfigurací series.DataLabels (a ChartDataLabelCollection) — jeho přepínače zobrazení nemají žádný viditelný účinek, když jsou popisky vypnuté. ShowValue, ShowCategoryName a ShowPercentage řídí, které informace se zobrazí, a Position je umisťuje relativně k datovému bodu.

Krok 5: Formátujte jednotlivý datový bod

Indexujte do DataPoints série (a ChartDataPointCollection), abyste získali jeden ChartDataPoint a nastavili jeho Format, Marker, Explosion nebo InvertIfNegative nezávisle na zbytku série. Takto zvýrazníte jeden sloupec, výsek nebo značku, aniž byste přetvořili celou sérii.