Utilizzo dei grafici in Aspose.Words per Java

Introduzione all’uso dei grafici in Aspose.Words per Java

In questo tutorial esploreremo come lavorare con i grafici utilizzando Aspose.Words per Java. Imparerai come creare vari tipi di grafici, personalizzare le proprietà degli assi, formattare le etichette dei dati e altro ancora. Immergiamoci!

Creazione di un grafico a linee

Per creare un grafico a linee, utilizzare il seguente codice:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0);
Chart chart = shape.getChart();
chart.getTitle().setText("Data Labels With Different Number Format");

// Elimina le serie generate predefinite.
chart.getSeries().clear();

// Aggiunta di una serie con dati ed etichette dati.
ChartSeries series1 = chart.getSeries().add("Aspose Series 1", 
    new String[] { "Category 1", "Category 2", "Category 3" }, 
    new double[] { 2.5, 1.5, 3.5 });

series1.hasDataLabels(true);
series1.getDataLabels().setShowValue(true);
series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00");
series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy");
series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%");

// Oppure collega il codice del formato a una cella di origine.
series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true);

doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx");

Creazione di altri tipi di grafici

Puoi creare diversi tipi di grafici come a colonne, ad area, a bolle, a dispersione e altro utilizzando tecniche simili. Ecco un esempio di inserimento di un semplice istogramma:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0);
Chart chart = shape.getChart();

// Elimina le serie generate predefinite.
chart.getSeries().clear();

// Creazione di categorie e aggiunta di dati.
String[] categories = new String[] { "Category 1", "Category 2" };
chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 });
chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 });

doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx");

Personalizzazione delle proprietà dell’asse

Puoi personalizzare le proprietà dell’asse, ad esempio modificare il tipo di asse, impostare segni di graduazione, formattare etichette e altro. Ecco un esempio di definizione delle proprietà dell’asse XY:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0);
Chart chart = shape.getChart();

// Cancella le serie predefinite e aggiungi i tuoi dati.

ChartAxis xAxis = chart.getAxisX();
ChartAxis yAxis = chart.getAxisY();

// Modifica l'asse X in una categoria anziché in una data.
xAxis.setCategoryType(AxisCategoryType.CATEGORY);
xAxis.setCrosses(AxisCrosses.CUSTOM);
xAxis.setCrossesAt(3.0); //Misurato in unità di visualizzazione dell'asse Y (centinaia).
xAxis.setReverseOrder(true);
xAxis.setMajorTickMark(AxisTickMark.CROSS);
xAxis.setMinorTickMark(AxisTickMark.OUTSIDE);
xAxis.setTickLabelOffset(200);

yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH);
yAxis.setMajorUnit(100.0);
yAxis.setMinorUnit(50.0);
yAxis.getDisplayUnit().setUnit(AxisBuiltInUnit.HUNDREDS);
yAxis.getScaling().setMinimum(new AxisBound(100.0));
yAxis.getScaling().setMaximum(new AxisBound(700.0));

doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx");

Formattazione delle etichette dati

È possibile formattare le etichette dati con diversi formati numerici. Ecco un esempio:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0);
Chart chart = shape.getChart();

// Cancella le serie predefinite e aggiungi i tuoi dati.

chart.getAxisY().getNumberFormat().setFormatCode("#,##0");

doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx");

Ulteriori personalizzazioni dei grafici

Puoi personalizzare ulteriormente i tuoi grafici regolando i limiti, le unità di intervallo tra le etichette, nascondendo gli assi del grafico e altro ancora. Esplora gli snippet di codice forniti per ulteriori informazioni su queste opzioni.

Conclusione

In questo tutorial, abbiamo esplorato come lavorare con i grafici utilizzando Aspose.Words per Java. Hai imparato come creare vari tipi di grafici, personalizzare le proprietà degli assi, formattare le etichette dei dati e altro ancora. Aspose.Words per Java fornisce potenti strumenti per aggiungere rappresentazioni visive dei dati ai tuoi documenti, migliorando il modo in cui presenti le informazioni.

Domande frequenti

Come posso aggiungere più serie a un grafico?

Puoi aggiungere più serie a un grafico utilizzando il comandochart.getSeries().add() metodo. Assicurati di specificare il nome della serie, le categorie e i valori dei dati.

Come posso formattare le etichette dati con formati numerici personalizzati?

È possibile formattare le etichette dati accedendo aDataLabels proprietà di una serie e impostando il codice del formato desiderato utilizzandogetNumberFormat().setFormatCode().

Come posso personalizzare le proprietà degli assi in un grafico?

Puoi personalizzare le proprietà degli assi come tipo, segni di graduazione, etichette e altro accedendo aChartAxis proprietà comesetCategoryType(), setCrosses() , EsetMajorTickMark().

Come posso creare altri tipi di grafici come i grafici a dispersione o ad area?

È possibile creare vari tipi di grafici specificando quelli appropriatiChartType quando si inserisce il grafico utilizzandobuilder.insertChart(ChartType.TYPE, width, height).

Come posso nascondere un asse del grafico?

È possibile nascondere un asse del grafico impostando il filesetHidden(true) proprietà dell’asse.