Class Trendline
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Représente une ligne de tendance dans un graphique.
public class Trendline : LineHéritage
Membres hérités
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()
Exemples
//Instanciation d'un objet Workbook
Workbook workbook = new Workbook();
//Ajout d'une nouvelle feuille de calcul à l'objet Excel
int sheetIndex = workbook.Worksheets.Add();
//Obtention de la référence de la feuille de calcul nouvellement ajoutée en passant son index
Worksheet worksheet = workbook.Worksheets[sheetIndex];
//Ajout d'une valeur d'exemple à la cellule "A1"
worksheet.Cells["A1"].PutValue(50);
//Ajout d'une valeur d'exemple à la cellule "A2"
worksheet.Cells["A2"].PutValue(100);
//Ajout d'une valeur d'exemple à la cellule "A3"
worksheet.Cells["A3"].PutValue(150);
//Ajout d'une valeur d'exemple à la cellule "A4"
worksheet.Cells["A4"].PutValue(200);
//Ajout d'une valeur d'exemple à la cellule "B1"
worksheet.Cells["B1"].PutValue(60);
//Ajout d'une valeur d'exemple à la cellule "B2"
worksheet.Cells["B2"].PutValue(32);
//Ajout d'une valeur d'exemple à la cellule "B3"
worksheet.Cells["B3"].PutValue(50);
//Ajout d'une valeur d'exemple à la cellule "B4"
worksheet.Cells["B4"].PutValue(40);
//Ajout d'une valeur d'exemple à la cellule "C1" en tant que donnée de catégorie
worksheet.Cells["C1"].PutValue("T1");
//Ajout d'une valeur d'exemple à la cellule "C2" en tant que donnée de catégorie
worksheet.Cells["C2"].PutValue("T2");
//Ajout d'une valeur d'exemple à la cellule "C3" en tant que donnée de catégorie
worksheet.Cells["C3"].PutValue("A1");
//Ajout d'une valeur d'exemple à la cellule "C4" en tant que donnée de catégorie
worksheet.Cells["C4"].PutValue("A2");
//Ajout d'un graphique à la feuille de calcul
int chartIndex = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5);
//Accès à l'instance du graphique nouvellement ajouté
Chart chart = worksheet.Charts[chartIndex];
//Ajout de NSeries (source de données du graphique) au graphique allant de la cellule "A1" à "B4"
chart.NSeries.Add("A1:B4", true);
//Définition de la source de données pour les données de catégorie de NSeries
chart.NSeries.CategoryData = "C1:C4";
//ajout d'une ligne de tendance linéaire
int index = chart.NSeries[0].TrendLines.Add(TrendlineType.Linear);
Trendline trendline = chart.NSeries[0].TrendLines[index];
//Définition du nom personnalisé de la ligne de tendance.
trendline.Name = "Linéaire";
//Affichage de l'équation sur le graphique
trendline.DisplayEquation = true;
//Affichage de la valeur R-Carré sur le graphique
trendline.DisplayRSquared = true;
//Sauvegarde du fichier Excel
workbook.Save("book1.xls");'Instanciation d'un objet Workbook
Dim workbook As Workbook = New Workbook()
'Ajout d'une nouvelle feuille de calcul à l'objet Excel
Dim sheetIndex As Int32 = workbook.Worksheets.Add()
'Obtention de la référence de la feuille de calcul nouvellement ajoutée en passant son index
Dim worksheet As Worksheet = workbook.Worksheets(sheetIndex)
'Ajout d'une valeur d'exemple à la cellule "A1"
worksheet.Cells("A1").PutValue(50)
'Ajout d'une valeur d'exemple à la cellule "A2"
worksheet.Cells("A2").PutValue(100)
'Ajout d'une valeur d'exemple à la cellule "A3"
worksheet.Cells("A3").PutValue(150)
'Ajout d'une valeur d'exemple à la cellule "A4"
worksheet.Cells("A4").PutValue(200)
'Ajout d'une valeur d'exemple à la cellule "B1"
worksheet.Cells("B1").PutValue(60)
'Ajout d'une valeur d'exemple à la cellule "B2"
worksheet.Cells("B2").PutValue(32)
'Ajout d'une valeur d'exemple à la cellule "B3"
worksheet.Cells("B3").PutValue(50)
'Ajout d'une valeur d'exemple à la cellule "B4"
worksheet.Cells("B4").PutValue(40)
'Ajout d'une valeur d'exemple à la cellule "C1" en tant que donnée de catégorie
worksheet.Cells("C1").PutValue("T1")
'Ajout d'une valeur d'exemple à la cellule "C2" en tant que donnée de catégorie
worksheet.Cells("C2").PutValue("T2")
'Ajout d'une valeur d'exemple à la cellule "C3" en tant que donnée de catégorie
worksheet.Cells("C3").PutValue("A1")
'Ajout d'une valeur d'exemple à la cellule "C4" en tant que donnée de catégorie
worksheet.Cells("C4").PutValue("A2")
'Ajout d'un graphique à la feuille de calcul
Dim chartIndex As Int32 = worksheet.Charts.Add(ChartType.Column, 5, 0, 15, 5)
'Accès à l'instance du graphique nouvellement ajouté
Dim chart As Chart = worksheet.Charts(chartIndex)
'Ajout de NSeries (source de données du graphique) au graphique allant de la cellule "A1" à "B4"
chart.NSeries.Add("A1:B4", True)
'Définition de la source de données pour les données de catégorie de NSeries
Chart.NSeries.CategoryData = "C1:C4"
'ajout d'une ligne de tendance linéaire
Dim index As Int32 = chart.NSeries(0).TrendLines.Add(TrendlineType.Linear)
Dim trendline As Trendline = chart.NSeries(0).TrendLines(index)
'Définition du nom personnalisé de la ligne de tendance.
trendline.Name = "Linéaire"
'Affichage de l'équation sur le graphique
trendline.DisplayEquation = True
'Affichage de la valeur R-Carré sur le graphique
trendline.DisplayRSquared = True
'Sauvegarde du fichier Excel
workbook.Save("book1.xls")Propriétés
Backward
Renvoie ou définit le nombre de périodes (ou unités sur un graphique de dispersion) que la ligne de tendance s’étend en arrière. Le nombre de périodes doit être supérieur ou égal à zéro. Si le type de graphique est colonne, le nombre de périodes doit être compris entre 0 et 0.5
public double Backward { get; set; }Valeur de la propriété
DataLabels
Représente l’objet DataLabels pour la série spécifiée.
public DataLabels DataLabels { get; }Valeur de la propriété
DisplayEquation
Représente si l’équation de la ligne de tendance est affichée sur le graphique (dans le même label de données que la valeur R-carré). Définir cette propriété sur True active automatiquement les labels de données.
public bool DisplayEquation { get; set; }Valeur de la propriété
DisplayRSquared
Représente si la valeur R-carré de la ligne de tendance est affichée sur le graphique (dans le même label de données que l’équation). Définir cette propriété sur True active automatiquement les labels de données.
public bool DisplayRSquared { get; set; }Valeur de la propriété
Forward
Renvoie ou définit le nombre de périodes (ou unités sur un graphique de dispersion) que la ligne de tendance s’étend en avant. Le nombre de périodes doit être supérieur ou égal à zéro.
public double Forward { get; set; }Valeur de la propriété
Intercept
Renvoie ou définit le point où la ligne de tendance croise l’axe des valeurs.
public double Intercept { get; set; }Valeur de la propriété
IsNameAuto
Renvoie si Microsoft Excel détermine automatiquement le nom de la ligne de tendance.
public bool IsNameAuto { get; set; }Valeur de la propriété
LegendEntry
Obtient l’entrée de légende selon cette ligne de tendance
public LegendEntry LegendEntry { get; }Valeur de la propriété
Name
Renvoie le nom de la ligne de tendance.
public string Name { get; set; }Valeur de la propriété
Order
Renvoie ou définit l’ordre de la ligne de tendance (un entier supérieur à 1) lorsque le type de ligne de tendance est Polynomiale. L’ordre doit être compris entre 2 et 6.
public int Order { get; set; }Valeur de la propriété
Period
Renvoie ou définit la période pour la ligne de tendance à moyenne mobile.
public int Period { get; set; }Remarques
Cette valeur doit être comprise entre 2 et 255. Et elle doit être inférieure au nombre de points du graphique dans la série.
Type
Renvoie le type de ligne de tendance.
public TrendlineType Type { get; }