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 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.
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 la 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 taille des 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 des courbes. True si le lissage des courbes est activé pour le graphique en courbes ou le graphique en nuages de points. S’applique uniquement aux graphiques linéaires et à nuages 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.
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 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 linéaire. S’applique uniquement aux graphiques en courbes.
has_series_lines	Vrai si un histogramme empilé ou un histogramme comporte des lignes de série ou si un graphique à secteurs ou à barres de secteurs 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 de secteurs.
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 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 en courbes ou en aires.
drop_lines	Renvoie un objet `Line` qui représente les lignes de dépôt d’une série sur le graphique en courbes ou en aires. S’applique uniquement aux graphiques en courbes ou en aires.
has_up_down_bars	Vrai si un graphique linéaire comporte des barres montantes et descendantes. S’applique uniquement aux graphiques en courbes.
up_bars	Renvoie un objet DropBars qui représente les barres montantes sur un graphique linéaire. S’applique uniquement aux graphiques en courbes.
down_bars	Renvoie un objet `DropBars` qui représente les barres descendantes sur un graphique linéaire. S’applique uniquement aux graphiques en courbes.
is_color_varied	Représente si la couleur des points varie. Le graphique ne doit contenir qu’une seule série.
gap_width	Renvoie ou définit l’espace entre les clusters de barres ou de colonnes, en 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 diagramme circulaire ou de diagramme 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 graphiques à barres et à 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 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 sur un secteur ou 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 de une tarte ou une barre de diagramme circulaire.
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 des bulles 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 pour cent.
explosion	La distance entre une tranche de secteur ouverte et le centre du diagramme à secteurs est exprimée en pourcentage du diamètre du secteur.
has_radar_axis_labels	True si un graphique radar comporte des étiquettes d’axe de catégorie. S’applique uniquement aux cartes radar.
has_leader_lines	Vrai si la série comporte 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	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