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
is_filtered	Indique si la série est sélectionnée ou filtrée. True signifie que cette série est filtrée et qu’elle ne sera pas affichée sur le graphique.
layout_properties	Représente les propriétés de la 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 Série.
border	Représente la bordure de l’objet Série.
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.
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 valeurs Y de cette série de graphiques.
values_format_code	Représente le code de format de la NumberList de Values.
x_values_format_code	Représente le code de format de la liste de nombres de valeurs X.
x_values	Représente les valeurs x de la série de graphiques.
bubble_sizes	Obtient ou définit les valeurs de taille des bulles de la série de graphiques.
trend_lines	Renvoie toutes les lignes de tendance de cette série.
smooth	Représente le lissage des courbes. Vrai si le lissage des courbes est activé pour le graphique linéaire ou le graphique en nuage de points. S’applique uniquement aux graphiques en lignes et en nuages de points reliés par des lignes.
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.
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 valeurs.
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	Vrai si le graphique linéaire comporte des lignes hautes et basses. S’applique uniquement aux graphiques linéaires.
hi_lo_lines	Renvoie un objet HiLoLines qui représente les lignes hautes-basses d’une série sur un graphique linéaire. S’applique uniquement aux graphiques linéaires.
has_series_lines	Vrai si un graphique à colonnes empilées ou un graphique à barres comporte des lignes de série ou si un graphique à secteurs ou un graphique à 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 pour un graphique à barres empilées ou un graphique à colonnes empilées. S’applique uniquement aux graphiques à barres empilées et à colonnes empilées.
has_drop_lines	Vrai 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 le graphique en aires. S’applique uniquement aux graphiques linéaires ou aux graphiques en aires.
has_up_down_bars	Vrai si un graphique linéaire comporte des barres montantes et descendantes. S’applique uniquement aux graphiques linéaires.
up_bars	Renvoie un objet DropBars qui représente les barres vers le haut sur un graphique linéaire. S’applique uniquement aux graphiques linéaires.
down_bars	Renvoie un objet `DropBars` qui représente les barres descendantes sur un graphique linéaire. S’applique uniquement aux graphiques linéaires.
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 du graphique à secteurs ou du 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 comment les barres et les colonnes sont positionnées. Peut être une valeur comprise entre – 100 et 100. S’applique uniquement aux graphiques à barres 2D et aux graphiques à colonnes 2D.
second_plot_size	Renvoie ou définit la taille de la section secondaire d’un graphique à secteurs ou d’une barre de graphique à secteurs, en pourcentage de la taille du gâteau primaire. 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 graphique à secteurs ou dans la deuxième barre d’un graphique à secteurs ou d’une barre de graphique à secteurs.
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 graphique à secteurs ou à barres sur un graphique à secteurs ou à barres.
is_auto_split	Indique si la valeur seuil est automatique.
bubble_scale	Obtient ou définit le facteur d’échelle pour les 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 représente la taille de la bulle sur un graphique à bulles.
show_negative_bubbles	Vrai 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 pour cent.
explosion	La distance entre une tranche de tarte ouverte et le centre du graphique à secteurs est exprimée en pourcentage du diamètre du secteur.
has_radar_axis_labels	Vrai si un graphique radar comporte des étiquettes d’axe de catégorie. S’applique uniquement aux graphiques 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. Elles relient les étiquettes de données aux points de données. Cet objet n’est pas une collection ; il n’y a aucun objet qui 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(self, 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