SparklineGroup classe

SparklineGroup classe

Sparkline est organisé en groupe sparkline. Un SparklineGroup contient un nombre variable d’éléments sparkline. Un groupe de graphiques sparkline spécifie le type, les paramètres d’affichage et les paramètres d’axe des graphiques sparkline.

Le type SparklineGroup expose les membres suivants :

Propriétés

Propriété Description
preset_style Obtient et définit le type de style prédéfini du groupe sparkline.
sparkline_collection Obtient la collection de l’objet Sparkline.
sparklines Obtient la collection de l’objet Sparkline.
type Indique le type de ligne sparkline du groupe de lignes sparkline.
plot_empty_cells_type Indique comment tracer les cellules vides.
display_hidden Indique s’il faut afficher les données dans des lignes et des colonnes masquées.
show_high_point Indique s’il faut mettre en surbrillance les points de données les plus élevés dans le groupe de graphiques sparkline.
high_point_color Obtient et définit la couleur des points de données les plus élevés dans le groupe de graphiques sparkline.
show_low_point Indique s’il faut mettre en surbrillance les points de données les plus bas dans le groupe de graphiques sparkline.
low_point_color Obtient et définit la couleur des points de données les plus bas dans le groupe de graphiques sparkline.
show_negative_points Indique s’il faut mettre en surbrillance les valeurs négatives du groupe de graphiques sparkline avec une couleur ou un marqueur différent.
negative_points_color Obtient et définit la couleur des valeurs négatives sur le groupe sparkline.
show_first_point Indique s’il faut mettre en surbrillance le premier point de données dans le groupe de graphiques sparkline.
first_point_color Obtient et définit la couleur du premier point de données dans le groupe sparkline.
show_last_point Indique s’il faut mettre en surbrillance le dernier point de données dans le groupe de graphiques sparkline.
last_point_color Obtient et définit la couleur du dernier point de données dans le groupe sparkline.
show_markers Indique s’il faut mettre en surbrillance chaque point de chaque ligne sparkline du groupe de lignes sparkline.
markers_color Obtient et définit la couleur des points dans chaque ligne sparkline du groupe de lignes sparkline.
series_color Obtient et définit la couleur des graphiques sparkline dans le groupe de graphiques sparkline.
plot_right_to_left Indique si les données du tracé sont de droite à gauche.
line_weight Obtient et définit l’épaisseur de ligne dans chaque ligne sparkline du groupe de lignes sparkline, dans l’unité de points.
horizontal_axis_color Obtient et définit la couleur de l’axe horizontal dans le groupe sparkline.
show_horizontal_axis Indique s’il faut afficher l’axe horizontal du graphique sparkline.
L’axe horizontal apparaît si le graphique sparkline contient des données qui croisent l’axe zéro.
horizontal_axis_date_range Représente la plage qui contient les valeurs de date pour les données sparkline.
vertical_axis_max_value_type Représente le type de valeur maximale de l’axe vertical.
vertical_axis_max_value Obtient et définit la valeur maximale personnalisée pour l’axe vertical.
vertical_axis_min_value_type Représente le type de valeur minimale de l’axe vertical.
vertical_axis_min_value Obtient et définit la valeur minimale personnalisée pour l’axe vertical.

Méthodes

Méthode Description
reset_ranges(data_range, is_vertical, location_range) Réinitialise la plage de données et la plage d’emplacement du groupe de graphiques sparkline.
Cette méthode effacera les éléments sparkline d’origine du groupe et créera de nouveaux éléments sparkline pour les nouvelles plages.

Exemple

from aspose.cells import CellArea, SaveFormat, Workbook
from aspose.cells.charts import SparklineType
from aspose.pydrawing import Color

book = Workbook()
sheet = book.worksheets[0]
sheet.cells.get("A1").put_value(5)
sheet.cells.get("B1").put_value(2)
sheet.cells.get("C1").put_value(1)
sheet.cells.get("D1").put_value(3)
#  Define the CellArea
ca = CellArea()
ca.start_column = 4
ca.end_column = 4
ca.start_row = 0
ca.end_row = 0
idx = sheet.sparkline_group_collection.add(SparklineType.LINE, "A1:D1", False, ca)
group = sheet.sparkline_group_collection[idx]
group.sparkline_collection.add(sheet.name + "!A1:D1", 0, 4)
#  Create CellsColor
clr = book.create_cells_color()
clr.color = Color.orange
group.series_color = clr
#  set the high points are colored green and the low points are colored red
group.show_high_point = True
group.show_low_point = True
group.high_point_color.color = Color.green
group.low_point_color.color = Color.red
#  set line weight
group.line_weight = 1.0
book.save("output.xlsx", SaveFormat.XLSX)

Voir également