Chart classe

Incapsula l’oggetto che rappresenta un singolo grafico di Excel.

Il tipo Chart espone i seguenti membri:

Proprietà

Proprietà	Descrizione
style	Ottiene e imposta lo stile incorporato.
chart_object	Rappresenta la forma del grafico;
hide_pivot_field_buttons	Indica se nascondere i pulsanti dei campi del grafico pivot solo quando il grafico è PivotChart.
pivot_options	Specifica i controlli pivot che appaiono sul grafico
pivot_source	La fonte sono i dati della tabella pivot. Se PivotSource non è vuoto, il grafico è PivotChart.
plot_by	Ottiene e imposta se il grafico viene tracciato per riga o per colonna.
plot_empty_cells_type	Ottiene e imposta come tracciare le celle vuote.
plot_visible_cells	Indica se nel grafico sono visibili solo le celle.
plot_visible_cells_only	Indica se nel grafico sono visibili solo le celle.
display_na_as_blank	Indica se visualizzare #N/D come valore vuoto.
name	Ottiene e imposta il nome del grafico.
size_with_window	Vero se Microsoft Excel ridimensiona il grafico per adattarlo alle dimensioni della finestra del foglio grafico.
worksheet	Ottiene il foglio di lavoro che contiene questo grafico.
shapes	Restituisce tutte le forme di disegno in questo grafico.
print_size	Ottiene e imposta la dimensione del grafico stampato.
type	Ottiene o imposta il tipo di un grafico.
n_series	Ottiene una raccolta `SeriesCollection` che rappresenta le serie di dati nel grafico.
filtered_n_series	Ottiene una raccolta `SeriesCollection` che rappresenta le serie di dati filtrate nel grafico.
title	Ottiene il titolo del grafico.
sub_title	Ottiene il sottotitolo del grafico. Solo per il formato file ODS.
plot_area	Ottiene l’area del grafico che include le etichette dei segni di graduazione degli assi.
chart_area	Ottiene l’area del grafico nel foglio di lavoro.
category_axis	Ottiene l’asse X del grafico.
value_axis	Ottiene l’asse Y del grafico.
second_value_axis	Ottiene il secondo asse Y del grafico.
second_category_axis	Ottiene il secondo asse X del grafico.
series_axis	Ottiene l’asse delle serie del grafico.
legend	Ottiene la legenda del grafico.
chart_data_table	Rappresenta la tabella dei dati del grafico.
show_legend	Ottiene o imposta un valore che indica se la legenda del grafico verrà visualizzata. Il valore predefinito è true.
is_rectangular_cornered	Ottiene o imposta un valore che indica se l’area del grafico ha angoli rettangolari. L’impostazione predefinita è vero.
show_data_table	Ottiene o imposta un valore che indica se il grafico visualizza una tabella dati.
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.
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.
gap_depth	Ottiene o imposta la distanza tra le serie di dati in un grafico 3D, come percentuale della larghezza del marcatore. Il valore di questa proprietà deve essere compreso tra 0 e 500.
floor	Restituisce un oggetto `Chart.floor` che rappresenta le pareti di un grafico 3D.
walls	Restituisce un oggetto `Chart.walls` che rappresenta le pareti di un grafico 3D.
back_wall	Restituisce un oggetto `Chart.walls` che rappresenta la parete posteriore di un grafico 3D.
side_wall	Restituisce un oggetto `Chart.walls` che rappresenta la parete laterale di un grafico 3D.
walls_and_gridlines_2d	Vero se le linee della griglia sono disegnate in modo bidimensionale su un grafico 3D.
rotation_angle	Rappresenta la rotazione della vista del grafico 3D (la rotazione dell’area del grafico attorno all’asse z, in gradi).
elevation	Rappresenta l’elevazione della vista del grafico 3D, in gradi.
right_angle_axes	Vero se gli assi del grafico sono ad angolo retto. Si applica solo ai grafici 3D (eccetto grafici a colonne 3D e grafici a torta 3D).
auto_scaling	Vero se Microsoft Excel ridimensiona un grafico 3D in modo che le sue dimensioni siano più vicine a quelle del grafico 2D equivalente. La proprietà RightAngleAxes deve essere True.
height_percent	Restituisce o imposta l’altezza di un grafico 3D come percentuale della larghezza del grafico (tra il 5 e il 500 percento).
perspective	Restituisce o imposta la prospettiva per la vista del grafico 3D. Deve essere compreso tra 0 e 100. Questa proprietà viene ignorata se la proprietà RightAngleAxes è True.
is_3d	Indica se il grafico è 3D.
depth_percent	Rappresenta la profondità di un grafico 3D come percentuale della larghezza del grafico (tra il 20 e il 2000 percento).
actual_chart_size	Ottiene la dimensione effettiva del grafico in pixel.
placement	Rappresenta il modo in cui il grafico è collegato alle celle sottostanti.
page_setup	Rappresenta la descrizione dell’impostazione della pagina in questo grafico.
line	Capisce la battuta.

Metodi

Metodo	Descrizione
`calculate(self)`	Calcola la posizione personalizzata dell’area del grafico e degli assi se la loro posizione è assegnata automaticamente.
`calculate(self, calculate_options)`	Calcola la posizione personalizzata dell’area del grafico e degli assi se la loro posizione è assegnata automaticamente, con le opzioni di calcolo del grafico.
`to_image(self, image_file)`	Crea l’immagine del grafico e la salva in un file. L’estensione del nome del file determina il formato dell’immagine.
`to_image(self, image_file, image_type)`	Crea l’immagine del grafico e la salva in un file nel tipo di immagine specificato.
`to_image(self, image_file, jpeg_quality)`	Crea l’immagine del grafico e la salva in un file in formato Jpeg.
`to_image(self, stream, jpeg_quality)`	Crea l’immagine del grafico e la salva in un flusso in formato Jpeg.
`to_image(self, stream, image_type)`	Crea l’immagine del grafico e la salva in un flusso nel formato specificato.
`to_image(self, image_file, options)`	Crea l’immagine del grafico e la salva in un file. L’estensione del nome del file determina il formato dell’immagine.
`to_image(self, stream, options)`	Crea l’immagine del grafico e la salva in un flusso nel formato specificato.
`to_pdf(self, file_name)`	Salva il grafico in un file PDF.
`to_pdf(self, file_name, desired_page_width, desired_page_height, h_alignment_type, v_alignment_type)`	Salva il grafico in un file PDF.
`to_pdf(self, stream)`	Crea il grafico in formato PDF e lo salva in un flusso.
`to_pdf(self, stream, desired_page_width, desired_page_height, h_alignment_type, v_alignment_type)`	Crea il grafico in formato PDF e lo salva in un flusso.
`is_refered_by_chart(self, row_index, column_index)`	Restituisce se la cella a cui fa riferimento il grafico.
`is_cell_refered_by_chart(self, sheet_index, row_index, column_index)`	Restituisce se la cella a cui fa riferimento il grafico.
`is_chart_data_changed(self)`	Rileva se l’origine dati di un grafico è cambiata.
`refresh_pivot_data(self)`	Aggiorna i dati del grafico dalla tabella pivot.
`change_template(self, data)`	Cambia il tipo di grafico con il modello preimpostato.
`move(self, upper_left_row, upper_left_column, lower_right_row, lower_right_column)`	Sposta il grafico in una posizione specificata.
`get_actual_size(self)`	Ottiene la dimensione effettiva del grafico in pixel.
`has_axis(self, aixs_type, is_primary)`	Restituisce gli assi presenti nel grafico.
`switch_row_column(self)`	Cambia riga/colonna.
`get_chart_data_range(self)`	Ottiene l’intervallo della sorgente dati del grafico.
`set_chart_data_range(self, area, is_vertical)`	Specifica l’intervallo di dati per un grafico.

Esempio

I seguenti codici mostrano come creare un grafico con codici .Net.

from aspose.cells import Workbook
from aspose.cells.charts import ChartType

workbook = Workbook()
sheet = workbook.worksheets[0]
cells = sheet.cells
cells.get(0, 1).put_value("Income")
cells.get(1, 0).put_value("Company A")
cells.get(2, 0).put_value("Company B")
cells.get(3, 0).put_value("Company C")
cells.get(1, 1).put_value(10000)
cells.get(2, 1).put_value(20000)
cells.get(3, 1).put_value(30000)
chartIndex = sheet.charts.add(ChartType.COLUMN, 9, 9, 21, 15)
chart = sheet.charts[chartIndex]
chart.set_chart_data_range("A1:B4", True)
chart.show_legend = True
chart.title.text = "Income Analysis"

Guarda anche

modulo aspose.cells.charts
classe SeriesCollection

AxisBins classe ChartArea classe