Class Trendline

Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)

Представляет собой линию тренда в графике.

public class Trendline : Line

Наследование

object ← Line ← Trendline

Унаследованные члены

Line.m_lineParent, Line.CompoundType, Line.DashType, Line.CapType, Line.JoinType, Line.BeginType, Line.EndType, Line.BeginArrowLength, Line.EndArrowLength, Line.BeginArrowWidth, Line.EndArrowWidth, Line.ThemeColor, Line.Color, Line.Transparency, Line.Style, Line.Weight, Line.WeightPt, Line.WeightPx, Line.FormattingType, Line.IsAutomaticColor, Line.IsVisible, Line.IsAuto, Line.GradientFill, object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Примеры

//Создание объекта Workbook
Workbook workbook = new Workbook();
//Добавление нового листа в объект Excel
int sheetIndex = workbook.Worksheets.Add();
//Получение ссылки на вновь добавленный лист, передав его индекс
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Добавление примерного значения в ячейку "A1"
worksheet.Cells["A1"].PutValue(50);
//Добавление примерного значения в ячейку "A2"
worksheet.Cells["A2"].PutValue(100);
//Добавление примерного значения в ячейку "A3"
worksheet.Cells["A3"].PutValue(150);
//Добавление примерного значения в ячейку "A4"
worksheet.Cells["A4"].PutValue(200);
//Добавление примерного значения в ячейку "B1"
worksheet.Cells["B1"].PutValue(60);
//Добавление примерного значения в ячейку "B2"
worksheet.Cells["B2"].PutValue(32);
//Добавление примерного значения в ячейку "B3"
worksheet.Cells["B3"].PutValue(50);
//Добавление примерного значения в ячейку "B4"
worksheet.Cells["B4"].PutValue(40);
//Добавление примерного значения в ячейку "C1" в качестве категориальных данных
worksheet.Cells["C1"].PutValue("Q1");
//Добавление примерного значения в ячейку "C2" в качестве категориальных данных
worksheet.Cells["C2"].PutValue("Q2");
//Добавление примерного значения в ячейку "C3" в качестве категориальных данных
worksheet.Cells["C3"].PutValue("Y1");
//Добавление примерного значения в ячейку "C4" в качестве категориальных данных
worksheet.Cells["C4"].PutValue("Y2");
//Добавление графика на лист
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5);
//Получение экземпляра вновь добавленного графика
Chart chart = worksheet.Charts[chartIndex];
//Добавление NSeries (источник данных графика) в график в диапазоне от ячейки "A1" до "B4"
chart.NSeries.Add("A1:B4", true);
//Установка источника данных для категориальных данных NSeries
chart.NSeries.CategoryData = "C1:C4";
//Добавление линейной линии тренда
int index = chart.NSeries[0].TrendLines.Add(TrendlineType.Linear);
Trendline trendline = chart.NSeries[0].TrendLines[index];
//Установка пользовательского названия линии тренда.
trendline.Name = "Линейная";
//Отображение уравнения на графике
trendline.DisplayEquation = true;
//Отображение значения R-квадрат на графике
trendline.DisplayRSquared = true;
//Сохранение файла Excel
workbook.Save("book1.xls");

'Создание объекта Workbook
Dim workbook As Workbook = New Workbook()
'Добавление нового листа в объект Excel
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'Получение ссылки на вновь добавленный лист, передав его индекс
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Добавление примерного значения в ячейку "A1"
worksheet.Cells("A1").PutValue(50)
'Добавление примерного значения в ячейку "A2"
worksheet.Cells("A2").PutValue(100)
'Добавление примерного значения в ячейку "A3"
worksheet.Cells("A3").PutValue(150)
'Добавление примерного значения в ячейку "A4"
worksheet.Cells("A4").PutValue(200)
'Добавление примерного значения в ячейку "B1"
worksheet.Cells("B1").PutValue(60)
'Добавление примерного значения в ячейку "B2"
worksheet.Cells("B2").PutValue(32)
'Добавление примерного значения в ячейку "B3"
worksheet.Cells("B3").PutValue(50)
'Добавление примерного значения в ячейку "B4"
worksheet.Cells("B4").PutValue(40)
'Добавление примерного значения в ячейку "C1" в качестве категориальных данных
worksheet.Cells("C1").PutValue("Q1")
'Добавление примерного значения в ячейку "C2" в качестве категориальных данных
worksheet.Cells("C2").PutValue("Q2")
'Добавление примерного значения в ячейку "C3" в качестве категориальных данных
worksheet.Cells("C3").PutValue("Y1")
'Добавление примерного значения в ячейку "C4" в качестве категориальных данных
worksheet.Cells("C4").PutValue("Y2")
'Добавление графика на лист
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'Получение экземпляра вновь добавленного графика
Dim chart As Chart = worksheet.Charts(chartIndex)
'Добавление NSeries (источник данных графика) в график в диапазоне от ячейки "A1" до "B4"
chart.NSeries.Add("A1:B4", True)
'Установка источника данных для категориальных данных NSeries
Chart.NSeries.CategoryData = "C1:C4"
'Добавление линейной линии тренда
Dim index As Int32 = chart.NSeries(0).TrendLines.Add(TrendlineType.Linear)
Dim trendline As Trendline = chart.NSeries(0).TrendLines(index)
'Установка пользовательского названия линии тренда.
trendline.Name = "Линейная"
'Отображение уравнения на графике
trendline.DisplayEquation = True
'Отображение значения R-квадрат на графике
trendline.DisplayRSquared = True
'Сохранение файла Excel
workbook.Save("book1.xls")

Свойства

Backward

Возвращает или устанавливает количество периодов (или единиц на диаграмме рассеяния), на которое линия тренда простирается назад. Количество периодов должно быть больше или равно нулю. Если тип графика - столбчатая, количество периодов должно находиться в диапазоне от 0 до 0.5

public double Backward { get; set; }

Значение свойства

double

DataLabels

Представляет объект DataLabels для указанной серии.

public DataLabels DataLabels { get; }

Значение свойства

DataLabels

DisplayEquation

Представляет, отображается ли уравнение для линии тренда на графике (в том же ярлыке данных, что и значение R-квадрат). Установка этого свойства в True автоматически включает ярлыки данных.

public bool DisplayEquation { get; set; }

Значение свойства

bool

DisplayRSquared

Представляет, отображается ли значение R-квадрат линии тренда на графике (в том же ярлыке данных, что и уравнение). Установка этого свойства в True автоматически включает ярлыки данных.

public bool DisplayRSquared { get; set; }

Значение свойства

bool

Forward

Возвращает или устанавливает количество периодов (или единиц на диаграмме рассеяния), на которое линия тренда простирается вперед. Количество периодов должно быть больше или равно нулю.

public double Forward { get; set; }

Значение свойства

double

Intercept

Возвращает или устанавливает точку, в которой линия тренда пересекает ось значений.

public double Intercept { get; set; }

Значение свойства

double

IsNameAuto

Возвращает, определяет ли Microsoft Excel автоматически название линии тренда.

public bool IsNameAuto { get; set; }

Значение свойства

bool

LegendEntry

Получает элемент легенды в соответствии с этой линией тренда

public LegendEntry LegendEntry { get; }

Значение свойства

LegendEntry

Name

Возвращает название линии тренда.

public string Name { get; set; }

Значение свойства

string

Order

Возвращает или устанавливает порядок линии тренда (целое число больше 1), когда тип линии тренда является полиномом. Порядок должен быть в диапазоне от 2 до 6.

public int Order { get; set; }

Значение свойства

int

Period

Возвращает или устанавливает период для линии тренда скользящей средней.

public int Period { get; set; }

Замечания

Это значение должно быть в диапазоне от 2 до 255. И оно должно быть меньше количества точек графика в серии.

Type

Возвращает тип линии тренда.

public TrendlineType Type { get; }

Значение свойства

TrendlineType