Series classe

Encapsule l’objet qui représente une seule série de données dans un graphique.

Le type Series expose les membres suivants :

Propriétés

Propriété	Description
layout_properties	Représente les propriétés de mise en page.
points	Obtient la collection de points d’une série dans un graphique.
area	Représente la zone d’arrière-plan de l’objet Series.
border	Représente la bordure de l’objet Series.
name	Obtient ou définit le nom de la série de données.
display_name	Obtient le nom de la série qui s’affiche sur le graphique du graphique.
count_of_data_values	Obtient le nombre de valeurs de données.
is_vertical_values	Indique si la source de données est verticale.
values	Représente les données de la série de graphiques.
values_format_code	Représente le code de format de NumberList de Values.
x_values	Représente les valeurs x de la série de graphiques.
bubble_sizes	Obtient ou définit les valeurs de tailles de bulles de la série de graphiques.
trend_lines	Renvoie un objet qui représente une collection de toutes les courbes de tendance de la série.
smooth	Représente le lissage de la courbe. True si le lissage des courbes est activé pour le graphique en courbes ou le graphique en nuage de points. S’applique uniquement aux graphiques linéaires et en nuage de points reliés par des graphiques linéaires.
shadow	Vrai si la série a une ombre.
has_3d_effect	Vrai si la série a une apparence tridimensionnelle. S’applique uniquement aux graphiques à bulles.
bar_3d_shape_type	Obtient ou définit le type de forme 3D utilisé avec le graphique à barres ou à colonnes 3D.
bar_shape	Obtient ou définit le type de forme 3D utilisé avec le graphique à barres ou à colonnes 3D.
data_labels	Représente l’objet DataLabels pour l’ASeries spécifié.
type	Obtient ou définit le type d’une série de données.
marker	Obtient le Series.marker.
plot_on_second_axis	Indique si cette série est tracée sur le deuxième axe des ordonnées.
x_error_bar	Représente la barre d’erreur de direction X de la série.
y_error_bar	Représente la barre d’erreur de direction Y de la série.
has_hi_lo_lines	True si le graphique en courbes comporte des lignes haut-bas. S’applique uniquement aux graphiques en courbes.
hi_lo_lines	Renvoie un objet HiLoLines qui représente les lignes haut-bas d’une série sur un graphique en courbes. S’applique uniquement aux graphiques en courbes.
has_series_lines	True si un histogramme empilé ou un graphique à barres comporte des lignes de série ou si un graphique à secteurs ou à barres comporte des lignes de connexion entre les deux sections. S’applique uniquement aux graphiques à colonnes empilées, aux graphiques à barres, aux graphiques à secteurs ou aux graphiques à barres.
series_lines	Renvoie un objet SeriesLines qui représente les lignes de série d’un graphique à barres empilées ou d’un graphique à colonnes empilées. S’applique uniquement aux histogrammes empilés et aux histogrammes empilés.
has_drop_lines	True si le graphique comporte des lignes de chute. S’applique uniquement aux graphiques linéaires ou aux graphiques en aires.
drop_lines	Renvoie un objet Line qui représente les lignes de chute d’une série sur le graphique en courbes ou en aires. S’applique uniquement aux graphiques linéaires ou aux graphiques en aires.
has_up_down_bars	True si un graphique en courbes comporte des barres vers le haut et vers le bas. S’applique uniquement aux graphiques en courbes.
up_bars	Renvoie un objet DropBars qui représente les barres supérieures d’un graphique en courbes. S’applique uniquement aux graphiques en courbes.
down_bars	Renvoie un objet DropBars qui représente les barres vers le bas sur un graphique en courbes. S’applique uniquement aux graphiques en courbes.
is_color_varied	Représente si la couleur des points est variée. Le graphique ne doit contenir qu’une seule série.
gap_width	Renvoie ou définit l’espace entre les groupes de barres ou de colonnes, sous forme de pourcentage de la largeur de la barre ou de la colonne. La valeur de cette propriété doit être comprise entre 0 et 500.
first_slice_angle	Obtient ou définit l’angle de la première tranche de graphique à secteurs ou de graphique en anneau, en degrés (dans le sens des aiguilles d’une montre à partir de la verticale). S’applique uniquement aux graphiques à secteurs, à secteurs 3D et en anneau, de 0 à 360.
overlap	Spécifie le positionnement des barres et des colonnes. Peut être une valeur comprise entre -100 et 100. S’applique uniquement aux histogrammes 2D et aux histogrammes 2D.
second_plot_size	Renvoie ou définit la taille de la section secondaire d’un camembert ou d’une barre de camembert, en pourcentage de la taille du gâteau principal. Peut être une valeur comprise entre 5 et 200.
split_type	Renvoie ou définit une valeur permettant de déterminer quels points de données se trouvent dans le deuxième secteur ou barre d’un secteur de secteur ou d’une barre de diagramme circulaire.
split_value	Renvoie ou définit une valeur qui doit être utilisée pour déterminer quels points de données se trouvent dans le deuxième secteur ou barre sur une tarte de tarte ou une barre de camembert.
is_auto_split	Indique si la valeur seuil est automatique.
bubble_scale	Obtient ou définit le facteur d’échelle des bulles dans le groupe de graphiques spécifié. Il peut s’agir d’une valeur entière comprise entre 0 (zéro) et 300, correspondant à un pourcentage de la taille par défaut. S’applique uniquement aux graphiques à bulles.
size_represents	Obtient ou définit ce que la taille de la bulle représente sur un graphique à bulles.
show_negative_bubbles	True si des bulles négatives sont affichées pour le groupe de graphiques. Valable uniquement pour les graphiques à bulles.
doughnut_hole_size	Renvoie ou définit la taille du trou dans un groupe de graphiques en anneau. La taille du trou est exprimée en pourcentage de la taille du graphique, entre 10 et 90 %.
explosion	La distance entre un secteur ouvert et le centre du graphique à secteurs est exprimée en pourcentage du diamètre du secteur.
has_radar_axis_labels	True si un graphique en radar comporte des étiquettes d’axe des catégories. S’applique uniquement aux cartes radar.
has_leader_lines	Vrai si la série a des lignes de repère.
leader_lines	Représente les lignes de repère sur un graphique. Les lignes de repère relient les étiquettes de données aux points de données. Cet objet n’est pas une collection ; aucun objet ne représente une seule ligne de repère.
legend_entry	Obtient l’entrée de légende selon cette série.
shape_properties	Obtient l’objet ShapePropertyCollection qui contient les propriétés de forme visuelle de la série.

Méthodes

Méthode	Description
move(count)	Déplace la série vers le haut ou vers le bas.

Exemple

from aspose.cells import Workbook
from aspose.cells.charts import ChartMarkerType, ChartType, FormattingType
from aspose.pydrawing import Color

# 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"
seriesIndex = chart.n_series.add("A1:B4", True)
# Setting the data source for the category data of NSeries
chart.n_series.category_data = "C1:C4"
series = chart.n_series[seriesIndex]
# Setting the values of the series.
series.values = "=B1:B4"
# Changing the chart type of the series.
series.type = ChartType.LINE
# Setting marker properties.
series.marker.marker_style = ChartMarkerType.CIRCLE
series.marker.foreground_color_set_type = FormattingType.AUTOMATIC
series.marker.foreground_color = Color.black
series.marker.background_color_set_type = FormattingType.AUTOMATIC
# do your business
# Saving the Excel file
workbook.save("book1.xls")

Voir également

PlotArea classe SeriesCollection classe