Class Trendline

命名空间: Aspose.Cells.Charts
程序集: 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 = "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; }

属性值

double

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; }

属性值

int

备注

此值应在 2 和 255 之间。并且必须小于系列中的图表点数

Type

返回趋势线的类型。

public TrendlineType Type { get; }

属性值

TrendlineType