Class Chart
Namespace: Aspose.Cells.Charts
Assembly: Aspose.Cells.dll (25.2.0)
Incapsula l’oggetto che rappresenta un singolo grafico Excel.
public class ChartEreditarietà
Membri ereditati
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Esempi
I seguenti codici mostrano come creare un grafico con codici .Net.
Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];
Cells cells = sheet.Cells;
cells[0,1].PutValue("Income");
cells[1,0].PutValue("Company A");
cells[2,0].PutValue("Company B");
cells[3,0].PutValue("Company C");
cells[1,1].PutValue(10000);
cells[2,1].PutValue(20000);
cells[3,1].PutValue(30000);
int chartIndex = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15);
Chart chart = sheet.Charts[chartIndex];
chart.SetChartDataRange("A1:B4", true);
chart.ShowLegend = true;
chart.Title.Text = "Income Analysis";Dim workbook as Workbook = new Workbook()
Dim sheet as Worksheet = workbook.Worksheets(0)
Dim cells as Cells = sheet.Cells
cells(0,1).PutValue("Income")
cells(1,0).PutValue("Company A")
cells(2,0).PutValue("Company B")
cells(3,0).PutValue("Company C")
cells(1,1).PutValue(10000)
cells(2,1).PutValue(20000)
cells(3,1).PutValue(30000)
Dim chartIndex as Integer = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15)
Dim chart as Chart = sheet.Charts(chartIndex)
chart.SetChartDataRange("A1:B4", True);
chart.ShowLegend = True
chart.Title.Text = "Income Analysis"Proprietà
ActualChartSize
Ottiene la dimensione effettiva del grafico in unità di pixel.
[Obsolete("Use Chart.GetActualSize() method instead.")]
public Size ActualChartSize { get; }Valore della Proprietà
Osservazioni
NOTA: Questo membro è ora obsoleto. Invece, si prega di utilizzare il metodo Chart.GetActualSize(). Questa proprietà verrà rimossa 12 mesi dopo luglio 2022. Aspose si scusa per eventuali disagi che potresti aver subito.
AutoScaling
Vero se Microsoft Excel scala un grafico 3-D in modo che sia più vicino in dimensione al grafico 2-D equivalente. La proprietà RightAngleAxes deve essere Vero.
public bool AutoScaling { get; set; }Valore della Proprietà
BackWall
Restituisce un oggetto Aspose.Cells.Charts.Chart.Walls che rappresenta il muro posteriore di un grafico 3-D.
public Walls BackWall { get; }Valore della Proprietà
CategoryAxis
Ottiene l’asse X del grafico.
public Axis CategoryAxis { get; }Valore della Proprietà
ChartArea
Ottiene l’area del grafico nel foglio di lavoro.
public ChartArea ChartArea { get; }Valore della Proprietà
ChartDataTable
Rappresenta la tabella dei dati del grafico.
public ChartDataTable ChartDataTable { get; }Valore della Proprietà
ChartObject
Rappresenta il graficoShape;
public ChartShape ChartObject { get; }Valore della Proprietà
DepthPercent
Rappresenta la profondità di un grafico 3-D come percentuale della larghezza del grafico (tra 20 e 2000 percento).
public int DepthPercent { get; set; }Valore della Proprietà
DisplayNaAsBlank
Indica se visualizzare #N/A come valore vuoto.
public bool DisplayNaAsBlank { get; set; }Valore della Proprietà
Elevation
Rappresenta l’elevazione della vista del grafico 3-D, in gradi.
public int Elevation { get; set; }Valore della Proprietà
Osservazioni
L’elevazione del grafico è l’altezza a cui si visualizza il grafico, in gradi. Il valore predefinito è 15 per la maggior parte dei tipi di grafico. Il valore di questa proprietà deve essere compreso tra -90 e 90, tranne per i grafici a barre 3-D, dove deve essere compreso tra 0 e 44.
FilteredNSeries
Ottiene una collezione Aspose.Cells.Charts.SeriesCollection che rappresenta le serie di dati filtrate nel grafico.
public SeriesCollection FilteredNSeries { get; }Valore della Proprietà
FirstSliceAngle
Ottiene o imposta l’angolo della prima fetta di grafico a torta o grafico a ciambella, in gradi (in senso orario rispetto alla verticale). Si applica solo ai grafici a torta, ai grafici a torta 3-D e ai grafici a ciambella, da 0 a 360.
public int FirstSliceAngle { get; set; }Valore della Proprietà
Floor
Restituisce un oggetto Aspose.Cells.Charts.Chart.Floor che rappresenta i muri di un grafico 3-D.
public Floor Floor { get; }Valore della Proprietà
Osservazioni
Questa proprietà non si applica ai grafici a torta 3-D.
GapDepth
Ottiene o imposta la distanza tra le serie di dati in un grafico 3-D, come percentuale della larghezza del marcatore. Il valore di questa proprietà deve essere compreso tra 0 e 500.
public int GapDepth { get; set; }Valore della Proprietà
GapWidth
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.
public int GapWidth { get; set; }Valore della Proprietà
HeightPercent
Restituisce o imposta l’altezza di un grafico 3-D come percentuale della larghezza del grafico (tra 5 e 500 percento).
public int HeightPercent { get; set; }Valore della Proprietà
HidePivotFieldButtons
Indica se nascondere i pulsanti dei campi del grafico pivot solo quando il grafico è un PivotChart.
public bool HidePivotFieldButtons { get; set; }Valore della Proprietà
Is3D
Indica se il grafico è un grafico 3D.
public bool Is3D { get; }Valore della Proprietà
IsRectangularCornered
Ottiene o imposta un valore che indica se l’area del grafico ha angoli rettangolari. Il predefinito è vero.
public bool IsRectangularCornered { get; set; }Valore della Proprietà
Legend
Ottiene la legenda del grafico.
public Legend Legend { get; }Valore della Proprietà
Line
Ottiene la linea.
public Line Line { get; }Valore della Proprietà
NSeries
Ottiene una collezione Aspose.Cells.Charts.SeriesCollection che rappresenta le serie di dati nel grafico.
public SeriesCollection NSeries { get; }Valore della Proprietà
Name
Ottiene e imposta il nome del grafico.
public string Name { get; set; }Valore della Proprietà
PageSetup
Rappresenta la descrizione della configurazione della pagina in questo grafico.
public PageSetup PageSetup { get; }Valore della Proprietà
Perspective
Restituisce o imposta la prospettiva per la vista del grafico 3-D. Deve essere compreso tra 0 e 100. Questa proprietà viene ignorata se la proprietà RightAngleAxes è Vero.
public short Perspective { get; set; }Valore della Proprietà
PivotOptions
Specifica i controlli pivot che appaiono sul grafico
public PivotOptions PivotOptions { get; }Valore della Proprietà
PivotSource
La sorgente è i dati della pivotTable. Se PivotSource non è vuoto, il grafico è un PivotChart.
public string PivotSource { get; set; }Valore della Proprietà
Osservazioni
Se la tabella pivot “PivotTable1” nel foglio di lavoro “Sheet1” nel file “Book1.xls”. Il pivotSource potrebbe essere “[Book1.xls]Sheet1!PivotTable1” se il grafico e la PivotTable non sono nella stessa cartella di lavoro. Se imposti questa proprietà, la precedente impostazione della sorgente dati andrà persa.
Placement
Rappresenta il modo in cui il grafico è attaccato alle celle sottostanti.
public PlacementType Placement { get; set; }Valore della Proprietà
PlotArea
Ottiene l’area di tracciamento del grafico che include le etichette degli assi.
public PlotArea PlotArea { get; }Valore della Proprietà
PlotBy
Ottiene e imposta se tracciare per riga o colonna.
public PlotDataByType PlotBy { get; }Valore della Proprietà
PlotEmptyCellsType
Ottiene e imposta come tracciare le celle vuote.
public PlotEmptyCellsType PlotEmptyCellsType { get; set; }Valore della Proprietà
PlotVisibleCellsOnly
Indica se tracciare solo le celle visibili.
public bool PlotVisibleCellsOnly { get; set; }Valore della Proprietà
PrintSize
Ottiene e imposta la dimensione del grafico stampato.
public PrintSizeType PrintSize { get; set; }Valore della Proprietà
RightAngleAxes
Vero se gli assi del grafico sono ad angoli retti. Si applica solo ai grafici 3-D (eccetto i grafici Column3D e 3-D Pie Charts).
public bool RightAngleAxes { get; set; }Valore della Proprietà
Osservazioni
Se questa proprietà è Vero, la proprietà Perspective viene ignorata.
RotationAngle
Rappresenta la rotazione della vista del grafico 3-D (la rotazione dell’area di tracciamento attorno all’asse z, in gradi).
public int RotationAngle { get; set; }Valore della Proprietà
Osservazioni
Il valore di questa proprietà deve essere compreso tra 0 e 360, tranne per i grafici a barre 3-D, dove il valore deve essere compreso tra 0 e 44. Il valore predefinito è 20. Si applica solo ai grafici 3-D.
SecondCategoryAxis
Ottiene il secondo asse X del grafico.
public Axis SecondCategoryAxis { get; }Valore della Proprietà
SecondValueAxis
Ottiene il secondo asse Y del grafico.
public Axis SecondValueAxis { get; }Valore della Proprietà
SeriesAxis
Ottiene l’asse delle serie del grafico.
public Axis SeriesAxis { get; }Valore della Proprietà
Shapes
Restituisce tutte le forme disegnate in questo grafico.
public ShapeCollection Shapes { get; }Valore della Proprietà
ShowDataTable
Ottiene o imposta un valore che indica se il grafico visualizza una tabella dati.
public bool ShowDataTable { get; set; }Valore della Proprietà
ShowLegend
Ottiene o imposta un valore che indica se la legenda del grafico sarà visualizzata. Il predefinito è vero.
public bool ShowLegend { get; set; }Valore della Proprietà
SideWall
Restituisce un oggetto Aspose.Cells.Charts.Chart.Walls che rappresenta il muro laterale di un grafico 3-D.
public Walls SideWall { get; }Valore della Proprietà
SizeWithWindow
Vero se Microsoft Excel ridimensiona il grafico per adattarlo alle dimensioni della finestra del foglio grafico.
public bool SizeWithWindow { get; set; }Valore della Proprietà
Style
Ottiene e imposta lo stile incorporato.
public int Style { get; set; }Valore della Proprietà
Osservazioni
Dovrebbe essere compreso tra 1 e 48. Restituisce -1 se non è stato impostato.
SubTitle
Ottiene il sottotitolo del grafico. Solo per file di formato ODS.
public Title SubTitle { get; }Valore della Proprietà
Title
Ottiene il titolo del grafico.
public Title Title { get; }Valore della Proprietà
Type
Ottiene o imposta il tipo di un grafico.
public ChartType Type { get; set; }Valore della Proprietà
ValueAxis
Ottiene l’asse Y del grafico.
public Axis ValueAxis { get; }Valore della Proprietà
Walls
Restituisce un oggetto Aspose.Cells.Charts.Chart.Walls che rappresenta i muri di un grafico 3-D.
public Walls Walls { get; }Valore della Proprietà
Osservazioni
Questa proprietà non si applica ai grafici a torta 3-D.
WallsAndGridlines2D
Vero se le linee della griglia sono disegnate in due dimensioni su un grafico 3-D.
public bool WallsAndGridlines2D { get; set; }Valore della Proprietà
Worksheet
Ottiene il foglio di lavoro che contiene questo grafico.
public Worksheet Worksheet { get; }Valore della Proprietà
Metodi
Calculate()
Calcola la posizione personalizzata dell’area di tracciamento, degli assi se la loro posizione è assegnata automaticamente.
public void Calculate()Calculate(ChartCalculateOptions)
Calcola la posizione personalizzata dell’area di tracciamento, degli assi se la loro posizione è assegnata automaticamente, con le Opzioni di Calcolo del Grafico.
public void Calculate(ChartCalculateOptions calculateOptions)Parametri
calculateOptions ChartCalculateOptions
ChangeTemplate(byte[])
Cambia il tipo di grafico con un modello preimpostato.
public void ChangeTemplate(byte[] data)Parametri
data byte[]
I dati del file modello del grafico (.crtx).
GetActualSize()
Ottiene la dimensione effettiva del grafico in unità di pixel.
public int[] GetActualSize()Restituisce
int[]
Dimensione effettiva in un array (larghezza e altezza). [0] è la larghezza; [1] è l’altezza.
GetChartDataRange()
Ottiene l’intervallo della sorgente dati del grafico.
public string GetChartDataRange()Restituisce
La sorgente dati.
Osservazioni
Supporta solo l’intervallo.
HasAxis(AxisType, bool)
Restituisce quali assi esistono sul grafico.
public bool HasAxis(AxisType aixsType, bool isPrimary)Parametri
aixsType AxisType
isPrimary bool
Restituisce
Osservazioni
Normalmente, i grafici a torta, a torta esplosa, a torta a barre, a torta 3-D, a torta 3-D esplosa, a ciambella, a ciambella esplosa non hanno assi.
IsCellReferedByChart(int, int, int)
Restituisce se la cella è referenziata dal grafico.
public bool IsCellReferedByChart(int sheetIndex, int rowIndex, int columnIndex)Parametri
sheetIndex int
L’indice del foglio. -1 significa il foglio di lavoro che contiene il grafico corrente.
rowIndex int
L’indice della riga
columnIndex int
L’indice della colonna
Restituisce
IsChartDataChanged()
Rileva se la sorgente dati di un grafico è cambiata.
public bool IsChartDataChanged()Restituisce
Restituisce vero se il grafico è cambiato altrimenti restituisce falso.
Osservazioni
Il metodo rileva le modifiche nella sorgente dati del grafico prima di renderizzare il grafico in formato immagine. Alla prima chiamata di Chart.toImage, i dati sorgente del grafico (ad es. XValuesParseData, ValuesParseData) verranno registrati. Prima di richiamare nuovamente il metodo Chart.toImage, chiama il metodo IsChartDataChanged per controllare se il grafico deve essere nuovamente renderizzato.
Move(int, int, int, int)
Sposta il grafico in una posizione specificata.
public void Move(int upperLeftRow, int upperLeftColumn, int lowerRightRow, int lowerRightColumn)Parametri
upperLeftRow int
Indice della riga in alto a sinistra.
upperLeftColumn int
Indice della colonna in alto a sinistra.
lowerRightRow int
Indice della riga in basso a destra
lowerRightColumn int
Indice della colonna in basso a destra
RefreshPivotData()
Aggiorna i dati del grafico dalla tabella pivot.
public void RefreshPivotData()Osservazioni
Raccoglieremo i dati dalla sorgente dati pivot per il rapporto della tabella pivot. Questo metodo è utilizzato solo per raccogliere tutti i dati in un grafico pivot.
SetChartDataRange(string, bool)
Specifica l’intervallo di dati per un grafico.
public void SetChartDataRange(string area, bool isVertical)Parametri
area string
Specifica i valori da cui tracciare le serie di dati
isVertical bool
Specifica se tracciare le serie da un intervallo di valori delle celle per riga o per colonna.
SwitchRowColumn()
Scambia riga/colonna.
public bool SwitchRowColumn()Restituisce
Falso significa che lo scambio di riga/colonna non riesce.
ToImage(string)
Crea l’immagine del grafico e la salva in un file. L’estensione del nome del file determina il formato dell’immagine.
public void ToImage(string imageFile)Parametri
imageFile string
Il nome del file immagine con percorso completo.
Osservazioni
Il formato dell'immagine è specificato utilizzando l'estensione del nome del file. Ad esempio, se specifichi "myfile.png", l'immagine verrà salvata nel formato PNG. Le seguenti estensioni di file sono riconosciute: .bmp, .gif, .png, .jpg, .jpeg, .tiff, .tif, .emf.
Se la larghezza o l'altezza è zero o il grafico non è supportato secondo l'elenco dei grafici supportati, questo metodo non farà nulla.ToImage(string, ImageType)
Crea l’immagine del grafico e la salva in un file nel tipo di immagine specificato.
public void ToImage(string imageFile, ImageType imageType)Parametri
imageFile string
Il nome del file immagine con percorso completo.
imageType ImageType
Il tipo di immagine in cui salvare l’immagine.
Osservazioni
Il tipo dell'immagine è specificato utilizzando `imageType`. I seguenti tipi sono supportati: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf.
Se la larghezza o l'altezza è zero o il grafico non è supportato secondo l'elenco dei grafici supportati, questo metodo non farà nulla.ToImage(string, long)
Crea l’immagine del grafico e la salva in un file nel formato Jpeg.
public void ToImage(string imageFile, long jpegQuality)Parametri
imageFile string
Il nome del file immagine con percorso completo.
jpegQuality long
Qualità Jpeg.
Osservazioni
Se la larghezza o l’altezza è zero o il grafico non è supportato secondo l’elenco dei grafici supportati, questo metodo non farà nulla.
ToImage(Stream, long)
Crea l’immagine del grafico e la salva in uno stream nel formato Jpeg.
public void ToImage(Stream stream, long jpegQuality)Parametri
stream Stream
Lo stream di output.
jpegQuality long
Qualità Jpeg.
Osservazioni
Se la larghezza o l’altezza è zero o il grafico non è supportato secondo l’elenco dei grafici supportati, questo metodo non farà nulla.
ToImage(Stream, ImageType)
Crea l’immagine del grafico e la salva in uno stream nel formato specificato.
public void ToImage(Stream stream, ImageType imageType)Parametri
stream Stream
Lo stream di output.
imageType ImageType
Il tipo di immagine in cui salvare l’immagine.
Osservazioni
Il tipo dell'immagine è specificato utilizzando `imageType`. I seguenti formati sono supportati: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf.
Se la larghezza o l'altezza è zero o il grafico non è supportato secondo l'elenco dei grafici supportati, questo metodo non farà nulla.ToImage(string, ImageOrPrintOptions)
Crea l’immagine del grafico e la salva in un file. L’estensione del nome del file determina il formato dell’immagine.
public void ToImage(string imageFile, ImageOrPrintOptions options)Parametri
imageFile string
Il nome del file immagine con percorso completo.
options ImageOrPrintOptions
Opzioni aggiuntive per la creazione dell’immagine
Esempi
Salva in Tiff con 300 dpi e compressione CCITT4.
ImageOrPrintOptions options = new ImageOrPrintOptions();
options.HorizontalResolution = 300;
options.VerticalResolution = 300;
options.TiffCompression = TiffCompression.CompressionCCITT4;
Workbook book = new Workbook(@"test.xls");
book.Worksheets[0].Charts[0].ToImage(@"chart.Tiff", options);
[VB]
Dim options As ImageOrPrintOptions = New ImageOrPrintOptions()
options.HorizontalResolution = 300
options.VerticalResolution = 300
options.TiffCompression = TiffCompression.CompressionCCITT4
Dim book As Workbook = New Workbook("test.xls")
book.Worksheets(0).Charts(0).ToImage("chart.Tiff", options)Salva in Jpeg con 300 dpi e qualità immagine 80.
ImageOrPrintOptions options = new ImageOrPrintOptions();
options.HorizontalResolution = 300;
options.VerticalResolution = 300;
options.Quality = 80;
Workbook book = new Workbook(@"test.xls");
book.Worksheets[0].Charts[0].ToImage(@"chart.Jpeg", options);
[VB]
Dim options As ImageOrPrintOptions = New ImageOrPrintOptions()
options.HorizontalResolution = 300
options.VerticalResolution = 300
options.Quality = 80
Dim book As Workbook = New Workbook("test.xls")
book.Worksheets(0).Charts(0).ToImage("chart.Jpeg", options)Osservazioni
Il formato dell'immagine è specificato utilizzando l'estensione del nome del file. Ad esempio, se specifichi "myfile.png", l'immagine verrà salvata nel formato PNG. Le seguenti estensioni di file sono riconosciute: .bmp, .gif, .png, .jpg, .jpeg, .tiff, .tif, .emf.
Se la larghezza o l'altezza è zero o il grafico non è supportato secondo l'elenco dei grafici supportati, questo metodo non farà nulla. Si prega di fare riferimento a Elenco dei Grafici Supportati per ulteriori dettagli.ToImage(Stream, ImageOrPrintOptions)
Crea l’immagine del grafico e la salva in uno stream nel formato specificato.
public void ToImage(Stream stream, ImageOrPrintOptions options)Parametri
stream Stream
Lo stream di output.
options ImageOrPrintOptions
Opzioni aggiuntive per la creazione dell’immagine
Osservazioni
Il tipo dell'immagine è specificato utilizzando `options.ImageType`. I seguenti formati sono supportati: ImageType.Bmp, ImageType.Gif, ImageType.Png, ImageType.Jpeg, ImageType.Tiff, ImageType.Emf.
Se la larghezza o l'altezza è zero o il grafico non è supportato secondo l'elenco dei grafici supportati, questo metodo non farà nulla. Si prega di fare riferimento a Elenco dei Grafici Supportati per ulteriori dettagli.ToPdf(string)
Salva il grafico in un file pdf.
public void ToPdf(string fileName)Parametri
fileName string
il nome del file pdf con percorso completo
ToPdf(string, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)
Salva il grafico in un file pdf.
public void ToPdf(string fileName, float desiredPageWidth, float desiredPageHeight, PageLayoutAlignmentType hAlignmentType, PageLayoutAlignmentType vAlignmentType)Parametri
fileName string
il nome del file pdf con percorso completo
desiredPageWidth float
La larghezza della pagina desiderata in pollici.
desiredPageHeight float
L’altezza della pagina desiderata in pollici.
hAlignmentType PageLayoutAlignmentType
Il tipo di allineamento orizzontale del grafico nella pagina di output.
vAlignmentType PageLayoutAlignmentType
Il tipo di allineamento verticale del grafico nella pagina di output.
ToPdf(Stream)
Crea il pdf del grafico e lo salva in uno stream.
public void ToPdf(Stream stream)Parametri
stream Stream
Lo stream di output.
ToPdf(Stream, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)
Crea il pdf del grafico e lo salva in uno stream.
public void ToPdf(Stream stream, float desiredPageWidth, float desiredPageHeight, PageLayoutAlignmentType hAlignmentType, PageLayoutAlignmentType vAlignmentType)Parametri
stream Stream
Lo stream di output.
desiredPageWidth float
La larghezza della pagina desiderata in pollici.
desiredPageHeight float
L’altezza della pagina desiderata in pollici.
hAlignmentType PageLayoutAlignmentType
Il tipo di allineamento orizzontale del grafico nella pagina di output.
vAlignmentType PageLayoutAlignmentType
Il tipo di allineamento verticale del grafico nella pagina di output.
