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 questa serie è filtrata e non verrà visualizzata nel 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 Series.
name	Ottiene o imposta il nome della serie di dati.
display_name	Ottiene il nome della serie visualizzato nel grafico del grafico.
count_of_data_values	Ottiene il numero dei valori dei dati.
is_vertical_values	Indica se l’origine dati è verticale.
values	Rappresenta i dati della serie di grafici.
values_format_code	Rappresenta il codice di formato di NumberList di Values.
x_values	Rappresenta i valori x della serie di grafici.
bubble_sizes	Ottiene o imposta i valori delle dimensioni delle bolle della serie di grafici.
trend_lines	Restituisce un oggetto che rappresenta una raccolta di tutte le linee di tendenza della serie.
smooth	Rappresenta lo smussamento della curva. Vero se l’arrotondamento della curva è attivato per il grafico a linee o il grafico a dispersione. Si applica solo ai grafici a linee e a dispersione collegati da grafici a 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 l’ASeries specificato.
type	Ottiene o imposta il tipo di una serie di dati.
marker	Ottiene lo `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 massimo-minimo. Si applica solo ai grafici a linee.
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 a linee.
has_series_lines	Vero se un istogramma in pila o un grafico a barre presenta linee in serie o se un grafico a torta o a barre presenta linee di collegamento tra le due sezioni. Si applica solo ai grafici a colonne in pila, ai grafici a barre, ai grafici a torta o ai grafici a torta a barre.
series_lines	Restituisce un oggetto SeriesLines che rappresenta le linee della serie per un grafico a barre in pila o un istogramma in pila. Si applica solo ai grafici a barre in pila e agli istogrammi in pila.
has_drop_lines	Vero se il grafico presenta linee di rilascio. Si applica solo ai grafici a linee o ai grafici ad area.
drop_lines	Restituisce un oggetto `Line` che rappresenta le linee di rilascio per una serie nel grafico a linee o nel grafico ad area. Si applica solo ai grafici a linee o ai grafici ad area.
has_up_down_bars	Vero se un grafico a linee presenta barre su e giù. Si applica solo ai grafici a linee.
up_bars	Restituisce un oggetto DropBars che rappresenta le barre verso l’alto su un grafico a linee. Si applica solo ai grafici a linee.
down_bars	Restituisce un oggetto `DropBars` che rappresenta le barre verso il basso su un grafico a linee. Si applica solo ai grafici a linee.
is_color_varied	Rappresenta se il colore dei punti è vario. Il grafico deve contenere una sola serie.
gap_width	Restituisce o imposta lo spazio tra i gruppi 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 sezione del grafico a torta o ad anello, in gradi (in senso orario dalla verticale). Si applica solo ai grafici a torta, a torta 3D e ad anello, 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 una barra del grafico a torta, come percentuale della dimensione della torta principale. Può essere un valore compreso tra 5 e 200.
split_type	Restituisce o imposta un valore che consente di determinare quali punti dati si trovano nella seconda torta o barra di una torta o barra di Grafico a torta.
split_value	Restituisce o imposta un valore che verrà utilizzato per determinare quali punti dati si trovano nella seconda torta o barra una torta o una barra del grafico a torta.
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 compreso tra 0 (zero) e 300, corrispondente a una percentuale della dimensione predefinita. Si applica solo ai grafici a bolle.
size_represents	Ottiene o imposta ciò che rappresenta la dimensione della bolla 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 ad anello. La dimensione del foro è espressa come percentuale della dimensione del grafico, compresa tra il 10 e il 90%.
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 dispone di etichette dell’asse delle categorie. Si applica solo alle carte radar.
has_leader_lines	Vero se la serie ha linee guida.
leader_lines	Rappresenta le linee guida su un grafico. Le linee direttrici 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à della forma visiva di Series.

Metodi

Metodo	Descrizione
move	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