Series classe

Incapsula l’oggetto che rappresenta una singola serie di dati in un grafico.

Il tipo Series espone i seguenti membri:

Proprietà

Proprietà	Descrizione
is_filtered	Indica se la serie è selezionata o filtrata. True indica che la serie è filtrata e non verrà visualizzata sul grafico.
layout_properties	Rappresenta le proprietà del layout.
points	Ottiene la raccolta di punti in una serie in un grafico.
area	Rappresenta l’area di sfondo dell’oggetto Serie.
border	Rappresenta il bordo dell’oggetto Serie.
name	Ottiene o imposta il nome della serie di dati.
display_name	Ottiene il nome della serie visualizzato nel grafico.
count_of_data_values	Ottiene il numero dei valori dei dati.
is_vertical_values	Indica se l’origine dati è verticale.
values	Rappresenta i valori Y di questa serie di grafici.
values_format_code	Rappresenta il codice di formato di NumberList di Values.
x_values_format_code	Rappresenta il codice di formato di NumberList di X Values.
x_values	Rappresenta i valori x della serie del grafico.
bubble_sizes	Ottiene o imposta i valori delle dimensioni delle bolle della serie di grafici.
trend_lines	Restituisce tutte le linee di tendenza di questa serie.
smooth	Rappresenta la levigatura della curva. Vero se la levigatura delle curve è attivata per il grafico a linee o per il grafico a dispersione. Si applica solo ai grafici a linee e a dispersione collegati da linee.
shadow	Vero se la serie ha un’ombra.
has_3d_effect	Vero se la serie ha un aspetto tridimensionale. Si applica solo ai grafici a bolle.
bar_3d_shape_type	Ottiene o imposta il tipo di forma 3D utilizzato con il grafico a barre o a colonne 3D.
data_labels	Rappresenta l’oggetto DataLabels per la ASeries specificata.
type	Ottiene o imposta il tipo di una serie di dati.
marker	Ottiene `Series.marker`.
plot_on_second_axis	Indica se questa serie è tracciata sul secondo asse dei valori.
x_error_bar	Rappresenta la barra di errore della direzione X della serie.
y_error_bar	Rappresenta la barra di errore della direzione Y della serie.
has_hi_lo_lines	Vero se il grafico a linee presenta linee alte e basse. Si applica solo ai grafici lineari.
hi_lo_lines	Restituisce un oggetto HiLoLines che rappresenta le linee massimo-minimo per una serie su un grafico a linee. Si applica solo ai grafici lineari.
has_series_lines	Vero se un grafico a colonne impilate o un grafico a barre ha linee di serie o se un grafico a torta o un grafico a barre presenta linee di collegamento tra le due sezioni. Si applica solo ai grafici a colonne impilate, ai grafici a barre, ai grafici a torta o ai grafici a barre di torta.
series_lines	Restituisce un oggetto SeriesLines che rappresenta le linee della serie per un grafico a barre in pila o un grafico a colonne in pila. Si applica solo ai grafici a barre impilate e ai grafici a colonne impilate.
has_drop_lines	Vero se il grafico presenta linee di caduta. Si applica solo ai grafici a linee o ad area.
drop_lines	Restituisce un oggetto `Line` che rappresenta le linee di caduta per una serie sul grafico a linee o sul grafico ad area. Si applica solo ai grafici a linee o ad area.
has_up_down_bars	Vero se un grafico a linee presenta barre ascendenti e discendenti. Si applica solo ai grafici lineari.
up_bars	Restituisce un oggetto DropBars che rappresenta le barre ascendenti su un grafico a linee. Si applica solo ai grafici lineari.
down_bars	Restituisce un oggetto `DropBars` che rappresenta le barre verticali su un grafico a linee. Si applica solo ai grafici lineari.
is_color_varied	Rappresenta se il colore dei punti è variato. Il grafico deve contenere una sola serie.
gap_width	Restituisce o imposta lo spazio tra i cluster di barre o colonne, come percentuale della larghezza della barra o della colonna. Il valore di questa proprietà deve essere compreso tra 0 e 500.
first_slice_angle	Ottiene o imposta l’angolo della prima fetta del grafico a torta o del grafico a ciambella, in gradi (in senso orario dalla verticale). Si applica solo ai grafici a torta, a torta 3D e a ciambella, da 0 a 360.
overlap	Specifica come vengono posizionate le barre e le colonne. Può essere un valore compreso tra -100 e 100. Si applica solo ai grafici a barre 2D e ai grafici a colonne 2D.
second_plot_size	Restituisce o imposta la dimensione della sezione secondaria di un grafico a torta o di un grafico a barre, come percentuale della dimensione della torta primaria. Può essere un valore compreso tra 5 e 200.
split_type	Restituisce o imposta un valore che indica come determinare quali punti dati si trovano nella seconda torta o barra di una torta o barra di una torta. grafico a torta.
split_value	Restituisce o imposta un valore che deve essere utilizzato per determinare quali punti dati si trovano nella seconda torta o barra su un grafico a torta o a barre.
is_auto_split	Indica se il valore di soglia è automatico.
bubble_scale	Ottiene o imposta il fattore di scala per le bolle nel gruppo di grafici specificato. Può essere un valore intero da 0 (zero) a 300, corrispondente a una percentuale della dimensione predefinita. Si applica solo ai grafici a bolle.
size_represents	Ottiene o imposta la dimensione della bolla rappresentata in un grafico a bolle.
show_negative_bubbles	Vero se vengono visualizzate bolle negative per il gruppo di grafici. Valido solo per i grafici a bolle.
doughnut_hole_size	Restituisce o imposta la dimensione del foro in un gruppo di grafici a ciambella. La dimensione del foro è espressa come percentuale della dimensione del grafico, compresa tra il 10 e il 90 percento.
explosion	La distanza di una fetta di torta aperta dal centro del grafico a torta è espressa come percentuale del diametro della torta.
has_radar_axis_labels	Vero se un grafico radar ha etichette sugli assi delle categorie. Si applica solo ai grafici radar.
has_leader_lines	Vero se la serie ha delle linee guida.
leader_lines	Rappresenta le linee guida su un grafico. Le linee guida collegano le etichette dati ai punti dati. Questo oggetto non è una raccolta: non esiste alcun oggetto che rappresenti una singola linea guida.
legend_entry	Ottiene la voce della legenda in base a questa serie.
shape_properties	Ottiene l’oggetto `ShapePropertyCollection` che contiene le proprietà di forma visiva della serie.

Metodi

Metodo	Descrizione
`move(self, count)`	Sposta la serie verso l’alto o verso il basso.

Esempio

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")

Guarda anche

PlotArea classe SeriesCollection classe