Class Trendline
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Представляє трендову лінію в графіку.
public class Trendline : Line
Спадкування
Спадковані члени
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 = "Linear";
//Відображення рівняння на графіку
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 = "Linear"
'Відображення рівняння на графіку
trendline.DisplayEquation = True
'Відображення значення R-квадрат на графіку
trendline.DisplayRSquared = True
'Збереження файлу Excel
workbook.Save("book1.xls")
Властивості
Backward
Повертає або встановлює кількість періодів (або одиниць на графіку розсіювання), на які трендова лінія розширюється назад. Кількість періодів повинна бути більшою або рівною нулю. Якщо тип графіка - стовпчиковий, кількість періодів повинна бути між 0 і 0.5.
public double Backward { get; set; }
Значення властивості
DataLabels
Представляє об’єкт DataLabels для вказаного ряду.
public DataLabels DataLabels { get; }
Значення властивості
DisplayEquation
Представляє, чи відображається рівняння для трендової лінії на графіку (в тому ж ярлику даних, що й значення R-квадрат). Встановлення цієї властивості в True автоматично вмикає ярлики даних.
public bool DisplayEquation { get; set; }
Значення властивості
DisplayRSquared
Представляє, чи відображається значення R-квадрат для трендової лінії на графіку (в тому ж ярлику даних, що й рівняння). Встановлення цієї властивості в True автоматично вмикає ярлики даних.
public bool DisplayRSquared { get; set; }
Значення властивості
Forward
Повертає або встановлює кількість періодів (або одиниць на графіку розсіювання), на які трендова лінія розширюється вперед. Кількість періодів повинна бути більшою або рівною нулю.
public double Forward { get; set; }
Значення властивості
Intercept
Повертає або встановлює точку, де трендова лінія перетинає ось значень.
public double Intercept { get; set; }
Значення властивості
IsNameAuto
Повертає, чи Microsoft Excel автоматично визначає ім’я трендової лінії.
public bool IsNameAuto { get; set; }
Значення властивості
LegendEntry
Отримує запис легенди відповідно до цієї трендової лінії.
public LegendEntry LegendEntry { get; }
Значення властивості
Name
Повертає ім’я трендової лінії.
public string Name { get; set; }
Значення властивості
Order
Повертає або встановлює порядок трендової лінії (ціле число більше 1), коли тип трендової лінії є поліноміальним. Порядок повинен бути між 2 і 6.
public int Order { get; set; }
Значення властивості
Period
Повертає або встановлює період для трендової лінії з ковзним середнім.
public int Period { get; set; }
Примітки
Це значення повинно бути між 2 і 255. І воно повинно бути меншим за кількість точок графіка в ряді.
Type
Повертає тип трендової лінії.
public TrendlineType Type { get; }