Lavorare con i grafici
Il nuovo insertChart metodo è stato aggiunto nel DocumentBuilder classe. Quindi, vediamo come inserire un grafico a colonna semplice nel documento utilizzando inserto Grafico metodo.
Come inserire un grafico da graffio utilizzando Aspose.Words
In questa sezione impareremo come inserire un grafico in un documento.
Inserisci grafico della colonna
Il seguente esempio di codice mostra come inserire il grafico della colonna:
Il codice produce il seguente risultato:
Ci sono quattro diversi sovraccarichi per la serie Aggiungi metodo, che sono stati esposti per coprire tutte le possibili varianti di fonti di dati per tutti i tipi di grafico:
Il codice produce il seguente risultato:
Inserire Scatter Grafico
Il seguente esempio di codice mostra come inserire un grafico scatter:
Il codice produce il seguente risultato:
Area di inserimento Grafico
Il seguente esempio di codice mostra come inserire un grafico dell’area:
Il codice produce il seguente risultato:
Inserisci il grafico della bolla
Il seguente esempio di codice mostra come inserire un grafico a bolle:
Il codice produce il seguente risultato:
Lavorare con Charts attraverso Shape.Chart
Oggetto
Una volta che il grafico è stato inserito e riempito di dati, si è in grado di cambiare il suo aspetto. Shape.Chart proprietà contiene tutte le opzioni relative al grafico disponibili attraverso il pubblico API.
Per esempio, cambiamo Titolo grafico o comportamento della leggenda:
Il codice genera i seguenti risultati:
Come Lavorare con ChartSeriesCollezione di Grafico
Guardiamo dentro ChartSeries collezione. Tutte le serie di grafici sono disponibili attraverso chart.getSeries() collezione, che è Iterable:
È possibile rimuovere la serie uno per uno o cancellare tutti loro e aggiungere una nuova, se necessario. Il grafico appena inserito ha alcune serie di default aggiunte a questa collezione. Per rimuoverli è necessario chiamare il chart.getSeries().clear() metodo.
Lavorare con Single ChartSeries Class
Ecco come lavorare con una serie particolare.
Si prega di vedere il risultato qui sotto:
Tutto singolo ChartSeries hanno predefinito ChartDataPoint opzioni, si prega di provare a utilizzare il seguente codice per cambiarli:
Come Lavorare con Single ChartDataPoint di un ChartSeries
Utilizzo ChartDataPoint si è in grado di personalizzare la formattazione di un singolo punto di dati della serie grafico:
Si prega di vedere il risultato qui sotto:
Come Lavorare con ChartDataLabel di una Serie Singola di Grafico
Utilizzo ChartDataLabel si è in grado di specificare la formattazione di una singola etichetta di dati della serie di grafici, come show/hide LegendKey, CategoryName, SeriesName, Valore ecc:
Si prega di vedere il risultato qui sotto:
Come definire opzioni di default per ChartDataLabels di ChartSeries
The ChartDataLabelCollection classe definisce le proprietà che possono essere utilizzate per impostare le opzioni di default per ChartDataLabels per Grafico Series. Queste strutture includono setShowCategoryName, setShowBubbleSize, setShowPercentage, setShowSeriesName, setShow Valore ecc:
Si prega di vedere il risultato qui sotto:
Come Formattare il Numero di Etichetta Dati Grafico
Usare il NumberFormat proprietà, è possibile specificare la formattazione del numero di una singola etichetta di dati del grafico.
Il seguente esempio di codice mostra come formattare un numero dell’etichetta dati:
Come impostare le proprietà dell’asse grafico
Se si desidera lavorare con l’asse grafico, la scala e le unità di visualizzazione per l’asse del valore, si prega di utilizzare ChartAxis, AxisDisplayUnit, e AxisScaling classi.
Il seguente esempio di codice mostra come definire le proprietà di assi X e Y:
Come Preparare il Tempo DateValore di tempo dell’Asse
Il seguente esempio di codice mostra come impostare i valori della data/ora alle proprietà dell’asse:
Come Formattare il Valore Numero di Asse
Il seguente esempio di codice mostra come modificare il formato dei numeri sull’asse del valore:
Come Impostare i Bound dell’Asse
The AxisBound
classe rappresenta un limite minimo o massimo di valori di asse. Bound può essere specificato come un valore numerico, data-time o “auto” speciale.
Il seguente esempio di codice mostra come impostare i limiti di un asse:
Come impostare l’unità di intervallazione tra le etichette
Il seguente esempio di codice mostra come impostare l’unità di intervallo tra le etichette su un asse:
Come Nascondere l’Asse Grafico
Se si desidera mostrare o nascondere l’asse grafico, è sufficiente raggiungere questo obiettivo impostando il valore di ChartAxis.Hidden
proprieta'.
Il seguente esempio di codice mostra come nascondere l’asse Y del grafico:
Come Allineare l’Etichetta di Grafico
Se si desidera impostare un allineamento di testo per le etichette multi-linee, è sufficiente raggiungere questo obiettivo impostando il valore di setTickLabelAlignment() proprieta'.
Il seguente esempio di codice mostra come spuntare l’allineamento delle etichette:
Come impostare il riempimento e la formattazione del freno
Formattazione di riempimento e corsa può essere impostato per la serie di grafici, punti di dati e marcatori. Per fare questo, è necessario utilizzare le proprietà della ChartFormat
tipo nelle classi ChartSeries, ChartDataPoint e ChartMarker, così come alias per alcune proprietà, come ForeColor, BackColor, Visibile e Trasparenza nella Stroke
classe.
Il seguente esempio di codice mostra come impostare il colore della serie:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
Chart chart = shape.Chart;
ChartSeriesCollection seriesColl = chart.Series;
// Delete default generated series.
seriesColl.Clear();
// Create category names array.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };
// Adding new series. Value and category arrays must be the same size.
ChartSeries series1 = seriesColl.Add("AW Series 1", categories, new double[] { 1, 2 });
ChartSeries series2 = seriesColl.Add("AW Series 2", categories, new double[] { 3, 4 });
ChartSeries series3 = seriesColl.Add("AW Series 3", categories, new double[] { 5, 6 });
// Set series color.
series1.Format.Fill.ForeColor = Color.Red;
series2.Format.Fill.ForeColor = Color.Yellow;
series3.Format.Fill.ForeColor = Color.Blue;
doc.Save("ColumnColor.docx");
Il seguente esempio di codice mostra come impostare il colore della linea e il peso:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
ChartSeriesCollection seriesColl = chart.Series;
// Delete default generated series.
seriesColl.Clear();
// Adding new series.
ChartSeries series1 = seriesColl.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 }, new double[] { 2.7, 3.2, 0.8 });
ChartSeries series2 = seriesColl.Add("AW Series 2", new double[] { 0.5, 1.5, 2.5 }, new double[] { 3, 1, 2 });
// Set series color.
series1.Format.Stroke.ForeColor = Color.Red;
series1.Format.Stroke.Weight = 5;
series2.Format.Stroke.ForeColor = Color.LightGreen;
series2.Format.Stroke.Weight = 5;
doc.Save("LineColorAndWeight.docx");