Работа с карти

Новият insertChart метод е добавен в DocumentBuilder Клас. И така, нека видим как да вкараме проста колона в документа, използвайки вмъкване Графика метод.

Как да въведете диаграма от четка използване Aspose.Words

В този раздел ще се научим как да вкараме диаграма в документ.

Вмъкване на колона

Следният пример за код показва как да се въведе колона диаграма:

Кодът дава следния резултат:

Има четири различни претоварвания за серията Добавете метод, който е бил изложен на всички възможни варианти на източници на данни за всички видове карти:

Кодът дава следния резултат:

Вмъкване на скатер Графика

Следният пример с код показва как да се вмъкне скатер диаграма:

Кодът дава следния резултат:

Вмъкване на зона Графика

Следният пример за код показва как да се вмъкне диаграма област:

Кодът дава следния резултат:

Вмъкване на таблицата с мехурчета

Следният пример за код показва как да се вмъкне балон диаграма:

Кодът дава следния резултат:

Работа с карти чрез Shape.Chart Обект

След като диаграмата е поставена и изпълнена с данни, вие сте в състояние да промените външния й вид. Shape.Chart имот съдържа всички опции, свързани с графиката, достъпни чрез обществеността API.

Например, нека се променим. Заглавие или поведение на легенда:

Кодът генерира следните резултати:

Как да работите с ChartSeriesCollection of Chart

Нека да погледна в ChartSeries Колекция. Всички серии карти са достъпни чрез chart.getSeries() събиране, което е Iterable:

Можете да премахнете серия един по един или да изчистите всички от тях, както и да добавите нова, ако е необходимо. Нововградената диаграма има някои добавени серии по подразбиране към тази колекция. За да ги премахнете, трябва да се обадите на диаграма.getSeries(). ясно() метод.

Работа с единични карти клас

Ето как се работи с определена серия.

Моля, вижте резултата по-долу:

Всички необвързани ChartSeries имате по подразбиране ChartDataPoint опции, моля опитайте се да използвате следния код, за да ги промените:

Как да работите с единична графикаDataPoint на a ChartSeries

Използване ChartDataPoint Вие сте в състояние да персонализира форматирането на една точка от данните на серията диаграма:

Моля, вижте резултата по-долу:

Как да работите с ChartDataLabel на единични карти

Използване ChartDataLabel Вие сте в състояние да посочи форматирането на един етикет на данните на серията диаграма, като шоу / скрий ЛегендаКей, Категория Име, SeriesName, Стойност и т.н.:

Моля, вижте резултата по-долу:

Как да определите настройките по подразбиране за ChartDataLabels на ChartSeries

На ChartDataLabelCollection клас определя свойствата, които могат да се използват за задаване на опции по подразбиране за ChartDataLabels за диаграма Series. Тези свойства включват setShow CategoryName, setShowBubbleSize, setShowPrescentage, setShowSeriesName, setShow Стойност и т.н.:

Моля, вижте резултата по-долу:

Как да форматираме номер на табелката

Използване на NumberFormat имот, можете да посочите числото форматиране на един етикет данни на диаграмата.

Следният пример за код показва как да се форматира редица от етикета на данните:

Как да зададете свойства на оста на графиката

Ако искате да работите с графична ос, мащабиране и дисплей единици за стойността ос, моля използвайте ChartAxis, AxisDisplayUnit, както и AxisScaling Класове.

Следният пример за код показва как да се определят свойствата на оста X и Y:

Как да зададете DateВремева стойност на оста

Следният пример за код показва как да се определят стойностите на дата/времето на осовите свойства:

Как да форматираме стойността на числото на оста

Следният пример за код показва как да промените формата на числата по оста на стойността:

Как да се определят границите на оста

На AxisBound класът представлява минимална или максимална граница на осите. Облигацията може да бъде посочена като цифрова, дата-време или специална “авто” стойност.

Следният пример за код показва как да се определят границите на оста:

Как да зададете интервал между етикетите

Следният пример за код показва как да се определи интервалната единица между етикетите на оста:

Как да скрием оста на графиката

Ако искате да покажете или скриете оста на диаграмата, можете просто да постигнете това чрез определяне на стойността на ChartAxis.Hidden собственост.

Следният пример за код показва как да се скрие оста Y на диаграмата:

Как да се подравнява етикет диаграма

Ако искате да зададете подравняване на текст за многолинейни етикети, можете просто да постигнете това чрез задаване на стойността на setTickLabelAlignment() собственост.

Следният пример за код показва как да маркирате подравняването на етикета:

Microsoft Word подравняване Чарт етикет към центъра по подразбиране.

Как да зададете форматиране на запълване и удар

Запълване и инсулт форматиране може да се настрои за серия диаграма, точки от данни, и маркери. За да направите това, трябва да използвате свойствата на ChartFormat тип в класа ChartSeries, ChartDataPoint и ChartMarker, както и псевдоними за някои имоти, като например ForeColor, BackColor, Visible, и прозрачност в Stroke Клас.

Следният пример за код показва как да зададете цвят серия:

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

Следният пример за код показва как да зададете цвят и тегло линия:

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