Class Trendline
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Representa uma linha de tendência em um gráfico.
public class Trendline : LineHerança
Membros Herdados
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()
Exemplos
//Instanciando um objeto Workbook
Workbook workbook = new Workbook();
//Adicionando uma nova planilha ao objeto Excel
int sheetIndex = workbook.Worksheets.Add();
//Obtendo a referência da nova planilha adicionada passando seu índice
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Adicionando um valor de exemplo à célula "A1"
worksheet.Cells["A1"].PutValue(50);
//Adicionando um valor de exemplo à célula "A2"
worksheet.Cells["A2"].PutValue(100);
//Adicionando um valor de exemplo à célula "A3"
worksheet.Cells["A3"].PutValue(150);
//Adicionando um valor de exemplo à célula "A4"
worksheet.Cells["A4"].PutValue(200);
//Adicionando um valor de exemplo à célula "B1"
worksheet.Cells["B1"].PutValue(60);
//Adicionando um valor de exemplo à célula "B2"
worksheet.Cells["B2"].PutValue(32);
//Adicionando um valor de exemplo à célula "B3"
worksheet.Cells["B3"].PutValue(50);
//Adicionando um valor de exemplo à célula "B4"
worksheet.Cells["B4"].PutValue(40);
//Adicionando um valor de exemplo à célula "C1" como dados de categoria
worksheet.Cells["C1"].PutValue("Q1");
//Adicionando um valor de exemplo à célula "C2" como dados de categoria
worksheet.Cells["C2"].PutValue("Q2");
//Adicionando um valor de exemplo à célula "C3" como dados de categoria
worksheet.Cells["C3"].PutValue("Y1");
//Adicionando um valor de exemplo à célula "C4" como dados de categoria
worksheet.Cells["C4"].PutValue("Y2");
//Adicionando um gráfico à planilha
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5);
//Acessando a instância do gráfico recém-adicionado
Chart chart = worksheet.Charts[chartIndex];
//Adicionando NSeries (fonte de dados do gráfico) ao gráfico variando de "A1" a "B4"
chart.NSeries.Add("A1:B4", true);
//Definindo a fonte de dados para os dados de categoria do NSeries
chart.NSeries.CategoryData = "C1:C4";
//adicionando uma linha de tendência linear
int index = chart.NSeries[0].TrendLines.Add(TrendlineType.Linear);
Trendline trendline = chart.NSeries[0].TrendLines[index];
//Definindo o nome personalizado da linha de tendência.
trendline.Name = "Linear";
//Exibindo a equação no gráfico
trendline.DisplayEquation = true;
//Exibindo o valor R-quadrado no gráfico
trendline.DisplayRSquared = true;
//Salvando o arquivo do Excel
workbook.Save("book1.xls");'Instanciando um objeto Workbook
Dim workbook As Workbook = New Workbook()
'Adicionando uma nova planilha ao objeto Excel
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'Obtendo a referência da nova planilha adicionada passando seu índice
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Adicionando um valor de exemplo à célula "A1"
worksheet.Cells("A1").PutValue(50)
'Adicionando um valor de exemplo à célula "A2"
worksheet.Cells("A2").PutValue(100)
'Adicionando um valor de exemplo à célula "A3"
worksheet.Cells("A3").PutValue(150)
'Adicionando um valor de exemplo à célula "A4"
worksheet.Cells("A4").PutValue(200)
'Adicionando um valor de exemplo à célula "B1"
worksheet.Cells("B1").PutValue(60)
'Adicionando um valor de exemplo à célula "B2"
worksheet.Cells("B2").PutValue(32)
'Adicionando um valor de exemplo à célula "B3"
worksheet.Cells("B3").PutValue(50)
'Adicionando um valor de exemplo à célula "B4"
worksheet.Cells("B4").PutValue(40)
'Adicionando um valor de exemplo à célula "C1" como dados de categoria
worksheet.Cells("C1").PutValue("Q1")
'Adicionando um valor de exemplo à célula "C2" como dados de categoria
worksheet.Cells("C2").PutValue("Q2")
'Adicionando um valor de exemplo à célula "C3" como dados de categoria
worksheet.Cells("C3").PutValue("Y1")
'Adicionando um valor de exemplo à célula "C4" como dados de categoria
worksheet.Cells("C4").PutValue("Y2")
'Adicionando um gráfico à planilha
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'Acessando a instância do gráfico recém-adicionado
Dim chart As Chart = worksheet.Charts(chartIndex)
'Adicionando NSeries (fonte de dados do gráfico) ao gráfico variando de "A1" a "B4"
chart.NSeries.Add("A1:B4", True)
'Definindo a fonte de dados para os dados de categoria do NSeries
Chart.NSeries.CategoryData = "C1:C4"
'adicionando uma linha de tendência linear
Dim index As Int32 = chart.NSeries(0).TrendLines.Add(TrendlineType.Linear)
Dim trendline As Trendline = chart.NSeries(0).TrendLines(index)
'Definindo o nome personalizado da linha de tendência.
trendline.Name = "Linear"
'Exibindo a equação no gráfico
trendline.DisplayEquation = True
'Exibindo o valor R-quadrado no gráfico
trendline.DisplayRSquared = True
'Salvando o arquivo do Excel
workbook.Save("book1.xls")Propriedades
Backward
Retorna ou define o número de períodos (ou unidades em um gráfico de dispersão) que a linha de tendência se estende para trás. O número de períodos deve ser maior ou igual a zero. Se o tipo de gráfico for coluna, o número de períodos deve estar entre 0 e 0,5
public double Backward { get; set; }Valor da Propriedade
DataLabels
Representa o objeto DataLabels para a série especificada.
public DataLabels DataLabels { get; }Valor da Propriedade
DisplayEquation
Representa se a equação da linha de tendência é exibida no gráfico (na mesma etiqueta de dados que o valor R-quadrado). Definir esta propriedade como True ativa automaticamente as etiquetas de dados.
public bool DisplayEquation { get; set; }Valor da Propriedade
DisplayRSquared
Representa se o valor R-quadrado da linha de tendência é exibido no gráfico (na mesma etiqueta de dados que a equação). Definir esta propriedade como True ativa automaticamente as etiquetas de dados.
public bool DisplayRSquared { get; set; }Valor da Propriedade
Forward
Retorna ou define o número de períodos (ou unidades em um gráfico de dispersão) que a linha de tendência se estende para frente. O número de períodos deve ser maior ou igual a zero.
public double Forward { get; set; }Valor da Propriedade
Intercept
Retorna ou define o ponto onde a linha de tendência cruza o eixo de valores.
public double Intercept { get; set; }Valor da Propriedade
IsNameAuto
Retorna se o Microsoft Excel determina automaticamente o nome da linha de tendência.
public bool IsNameAuto { get; set; }Valor da Propriedade
LegendEntry
Obtém a entrada da legenda de acordo com esta linha de tendência
public LegendEntry LegendEntry { get; }Valor da Propriedade
Name
Retorna o nome da linha de tendência.
public string Name { get; set; }Valor da Propriedade
Order
Retorna ou define a ordem da linha de tendência (um inteiro maior que 1) quando o tipo de linha de tendência é Polinomial. A ordem deve estar entre 2 e 6.
public int Order { get; set; }Valor da Propriedade
Period
Retorna ou define o período para a linha de tendência de média móvel.
public int Period { get; set; }Observações
Este valor deve estar entre 2 e 255. E deve ser menor que o número de pontos do gráfico na série.
Type
Retorna o tipo de linha de tendência.
public TrendlineType Type { get; }