Class Trendline
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Representa una línea de tendencia en un gráfico.
public class Trendline : LineHerencia
Miembros heredados
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()
Ejemplos
//Instanciar un objeto Workbook
Workbook workbook = new Workbook();
//Agregar una nueva hoja de trabajo al objeto Excel
int sheetIndex = workbook.Worksheets.Add();
//Obtener la referencia de la nueva hoja de trabajo agregada pasando su índice de hoja
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Agregar un valor de ejemplo a la celda "A1"
worksheet.Cells["A1"].PutValue(50);
//Agregar un valor de ejemplo a la celda "A2"
worksheet.Cells["A2"].PutValue(100);
//Agregar un valor de ejemplo a la celda "A3"
worksheet.Cells["A3"].PutValue(150);
//Agregar un valor de ejemplo a la celda "A4"
worksheet.Cells["A4"].PutValue(200);
//Agregar un valor de ejemplo a la celda "B1"
worksheet.Cells["B1"].PutValue(60);
//Agregar un valor de ejemplo a la celda "B2"
worksheet.Cells["B2"].PutValue(32);
//Agregar un valor de ejemplo a la celda "B3"
worksheet.Cells["B3"].PutValue(50);
//Agregar un valor de ejemplo a la celda "B4"
worksheet.Cells["B4"].PutValue(40);
//Agregar un valor de ejemplo a la celda "C1" como dato de categoría
worksheet.Cells["C1"].PutValue("Q1");
//Agregar un valor de ejemplo a la celda "C2" como dato de categoría
worksheet.Cells["C2"].PutValue("Q2");
//Agregar un valor de ejemplo a la celda "C3" como dato de categoría
worksheet.Cells["C3"].PutValue("Y1");
//Agregar un valor de ejemplo a la celda "C4" como dato de categoría
worksheet.Cells["C4"].PutValue("Y2");
//Agregar un gráfico a la hoja de trabajo
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5);
//Acceder a la instancia del gráfico recién agregado
Chart chart = worksheet.Charts[chartIndex];
//Agregar NSeries (fuente de datos del gráfico) al gráfico desde la celda "A1" hasta "B4"
chart.NSeries.Add("A1:B4", true);
//Establecer la fuente de datos para los datos de categoría de NSeries
chart.NSeries.CategoryData = "C1:C4";
//Agregar una línea de tendencia lineal
int index = chart.NSeries[0].TrendLines.Add(TrendlineType.Linear);
Trendline trendline = chart.NSeries[0].TrendLines[index];
//Establecer el nombre personalizado de la línea de tendencia.
trendline.Name = "Lineal";
//Mostrar la ecuación en el gráfico
trendline.DisplayEquation = true;
//Mostrar el valor R-Cuadrado en el gráfico
trendline.DisplayRSquared = true;
//Guardar el archivo de Excel
workbook.Save("book1.xls");'Instanciar un objeto Workbook
Dim workbook As Workbook = New Workbook()
'Agregar una nueva hoja de trabajo al objeto Excel
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'Obtener la referencia de la nueva hoja de trabajo agregada pasando su índice de hoja
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Agregar un valor de ejemplo a la celda "A1"
worksheet.Cells("A1").PutValue(50)
'Agregar un valor de ejemplo a la celda "A2"
worksheet.Cells("A2").PutValue(100)
'Agregar un valor de ejemplo a la celda "A3"
worksheet.Cells("A3").PutValue(150)
'Agregar un valor de ejemplo a la celda "A4"
worksheet.Cells("A4").PutValue(200)
'Agregar un valor de ejemplo a la celda "B1"
worksheet.Cells("B1").PutValue(60)
'Agregar un valor de ejemplo a la celda "B2"
worksheet.Cells("B2").PutValue(32)
'Agregar un valor de ejemplo a la celda "B3"
worksheet.Cells("B3").PutValue(50)
'Agregar un valor de ejemplo a la celda "B4"
worksheet.Cells("B4").PutValue(40)
'Agregar un valor de ejemplo a la celda "C1" como dato de categoría
worksheet.Cells("C1").PutValue("Q1")
'Agregar un valor de ejemplo a la celda "C2" como dato de categoría
worksheet.Cells("C2").PutValue("Q2")
'Agregar un valor de ejemplo a la celda "C3" como dato de categoría
worksheet.Cells("C3").PutValue("Y1")
'Agregar un valor de ejemplo a la celda "C4" como dato de categoría
worksheet.Cells("C4").PutValue("Y2")
'Agregar un gráfico a la hoja de trabajo
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'Acceder a la instancia del gráfico recién agregado
Dim chart As Chart = worksheet.Charts(chartIndex)
'Agregar NSeries (fuente de datos del gráfico) al gráfico desde la celda "A1" hasta "B4"
chart.NSeries.Add("A1:B4", True)
'Establecer la fuente de datos para los datos de categoría de NSeries
Chart.NSeries.CategoryData = "C1:C4"
'Agregar una línea de tendencia lineal
Dim index As Int32 = chart.NSeries(0).TrendLines.Add(TrendlineType.Linear)
Dim trendline As Trendline = chart.NSeries(0).TrendLines(index)
'Establecer el nombre personalizado de la línea de tendencia.
trendline.Name = "Lineal"
'Mostrar la ecuación en el gráfico
trendline.DisplayEquation = True
'Mostrar el valor R-Cuadrado en el gráfico
trendline.DisplayRSquared = True
'Guardar el archivo de Excel
workbook.Save("book1.xls")Propiedades
Backward
Devuelve o establece el número de períodos (o unidades en un gráfico de dispersión) que la línea de tendencia se extiende hacia atrás. El número de períodos debe ser mayor o igual a cero. Si el tipo de gráfico es columna, el número de períodos debe estar entre 0 y 0.5
public double Backward { get; set; }Valor de propiedad
DataLabels
Representa el objeto DataLabels para la serie especificada.
public DataLabels DataLabels { get; }Valor de propiedad
DisplayEquation
Representa si la ecuación de la línea de tendencia se muestra en el gráfico (en la misma etiqueta de datos que el valor R-cuadrado). Establecer esta propiedad en True activa automáticamente las etiquetas de datos.
public bool DisplayEquation { get; set; }Valor de propiedad
DisplayRSquared
Representa si el valor R-cuadrado de la línea de tendencia se muestra en el gráfico (en la misma etiqueta de datos que la ecuación). Establecer esta propiedad en True activa automáticamente las etiquetas de datos.
public bool DisplayRSquared { get; set; }Valor de propiedad
Forward
Devuelve o establece el número de períodos (o unidades en un gráfico de dispersión) que la línea de tendencia se extiende hacia adelante. El número de períodos debe ser mayor o igual a cero.
public double Forward { get; set; }Valor de propiedad
Intercept
Devuelve o establece el punto donde la línea de tendencia cruza el eje de valores.
public double Intercept { get; set; }Valor de propiedad
IsNameAuto
Devuelve si Microsoft Excel determina automáticamente el nombre de la línea de tendencia.
public bool IsNameAuto { get; set; }Valor de propiedad
LegendEntry
Obtiene la entrada de leyenda de acuerdo con esta línea de tendencia
public LegendEntry LegendEntry { get; }Valor de propiedad
Name
Devuelve el nombre de la línea de tendencia.
public string Name { get; set; }Valor de propiedad
Order
Devuelve o establece el orden de la línea de tendencia (un entero mayor que 1) cuando el tipo de línea de tendencia es Polinómico. El orden debe estar entre 2 y 6.
public int Order { get; set; }Valor de propiedad
Period
Devuelve o establece el período para la línea de tendencia de media móvil.
public int Period { get; set; }Valor de propiedad
Observaciones
Este valor debe estar entre 2 y 255. Y debe ser menor que el número de puntos del gráfico en la serie.
Type
Devuelve el tipo de línea de tendencia.
public TrendlineType Type { get; }