Trendline classe

Trendline classe

Représente une ligne de tendance dans un graphique.

Héritage: TrendlineLine

Le type Trendline expose les membres suivants :

Propriétés

PropriétéDescription
compound_typeSpécifie le type de ligne composée
dash_typeSpécifie le type de ligne pointillée
cap_typeSpécifie les majuscules de fin.
join_typeSpécifie les capuchons de jonction.
begin_typeSpécifie une pointe de flèche pour le début d’une ligne.
end_typeSpécifie une pointe de flèche pour la fin d’une ligne.
begin_arrow_lengthSpécifie la longueur de la pointe de flèche pour le début d’une ligne.
end_arrow_lengthSpécifie la longueur de la pointe de flèche pour la fin d’une ligne.
begin_arrow_widthSpécifie la largeur de la pointe de flèche pour le début d’une ligne.
end_arrow_widthSpécifie la largeur de la pointe de flèche pour la fin d’une ligne.
theme_colorObtient et définit la couleur du thème.
colorReprésente la couleur de la ligne.
transparencyRenvoie ou définit le degré de transparence de la ligne sous la forme d’une valeur comprise entre 0,0 (opaque) et 1,0 (clair).
styleReprésente le style de la ligne.
weightObtient ou définit le WeightType de la ligne.
weight_ptObtient ou définit l’épaisseur de la ligne en unité de points.
weight_pxObtient ou définit l’épaisseur de la ligne en unités de pixels.
formatting_typeObtient ou définit le type de format.
is_automatic_colorIndique si la couleur du trait est attribuée automatiquement.
is_visibleReprésente si la ligne est visible.
is_autoIndique si ce style de ligne est attribué automatiquement.
gradient_fillReprésente un remplissage dégradé.
is_name_autoRenvoie si Microsoft Excel détermine automatiquement le nom de la courbe de tendance.
typeRenvoie le type de ligne de tendance.
nameRenvoie le nom de la ligne de tendance.
orderRenvoie ou définit l’ordre de la courbe de tendance (un entier supérieur à 1) lorsque le type de courbe de tendance est Polynomial.
La commande doit être comprise entre 2 et 6.
periodRenvoie ou définit la période de la ligne de tendance de la moyenne mobile.
forwardRenvoie ou définit le nombre de périodes (ou d’unités sur un nuage de points) que la ligne de tendance s’étend vers l’avant.
Le nombre de périodes doit être supérieur ou égal à zéro.
backwardRenvoie ou définit le nombre de périodes (ou d’unités sur un nuage de points) que la ligne de tendance s’étend vers l’arrière.
Le nombre de périodes doit être supérieur ou égal à zéro.
Si le type de graphique est en colonnes, le nombre de périodes doit être compris entre 0 et 0,5
display_equationReprésente si l’équation de la ligne de tendance est affichée sur le graphique (dans la même étiquette de données que la valeur R au carré). La définition de cette propriété sur True active automatiquement les étiquettes de données.
display_r_squaredReprésente si la valeur R au carré de la courbe de tendance est affichée sur le graphique (dans la même étiquette de données que l’équation). La définition de cette propriété sur True active automatiquement les étiquettes de données.
interceptRenvoie ou définit le point où la ligne de tendance croise l’axe des valeurs.
data_labelsReprésente l’objet DataLabels pour la série spécifiée.
legend_entryObtient l’entrée de légende selon cette ligne de tendance

Exemple

from aspose.cells import Workbook
from aspose.cells.charts import ChartType, TrendlineType

# Instantiating a Workbook object
workbook = Workbook()
# Adding a new worksheet to the Excel object
sheetIndex = workbook.worksheets.add()
# Obtaining the reference of the newly added worksheet by passing its sheet index
worksheet = workbook.worksheets[sheetIndex]
# Adding a sample value to "A1" cell
worksheet.cells.get("A1").put_value(50)
# Adding a sample value to "A2" cell
worksheet.cells.get("A2").put_value(100)
# Adding a sample value to "A3" cell
worksheet.cells.get("A3").put_value(150)
# Adding a sample value to "A4" cell
worksheet.cells.get("A4").put_value(200)
# Adding a sample value to "B1" cell
worksheet.cells.get("B1").put_value(60)
# Adding a sample value to "B2" cell
worksheet.cells.get("B2").put_value(32)
# Adding a sample value to "B3" cell
worksheet.cells.get("B3").put_value(50)
# Adding a sample value to "B4" cell
worksheet.cells.get("B4").put_value(40)
# Adding a sample value to "C1" cell as category data
worksheet.cells.get("C1").put_value("Q1")
# Adding a sample value to "C2" cell as category data
worksheet.cells.get("C2").put_value("Q2")
# Adding a sample value to "C3" cell as category data
worksheet.cells.get("C3").put_value("Y1")
# Adding a sample value to "C4" cell as category data
worksheet.cells.get("C4").put_value("Y2")
# Adding a chart to the worksheet
chartIndex = worksheet.charts.add(ChartType.COLUMN, 5, 0, 15, 5)
# Accessing the instance of the newly added chart
chart = worksheet.charts[chartIndex]
# Adding NSeries (chart data source) to the chart ranging from "A1" cell to "B4"
chart.n_series.add("A1:B4", True)
# Setting the data source for the category data of NSeries
chart.n_series.category_data = "C1:C4"
# adding a linear trendline
index = chart.n_series[0].trend_lines.add(TrendlineType.LINEAR)
trendline = chart.n_series[0].trend_lines[index]
# Setting the custom name of the trendline.
trendline.name = "Linear"
# Displaying the equation on chart
trendline.display_equation = True
# Displaying the R-Squared value on chart
trendline.display_r_squared = True
# Saving the Excel file
workbook.save("book1.xls")

Voir également