Utilizzo di 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 usando 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 di default.
chart.getSeries().clear();

// Aggiungere 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 ancora usando tecniche simili. Ecco un esempio di inserimento di un semplice grafico a colonne:

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 di default.
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 modificando il tipo di asse, impostando segni di spunta, formattando 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();

// Modificare l'asse X in modo che sia una categoria anziché 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

Puoi 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 del grafico

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 i frammenti di codice forniti per saperne di più su queste opzioni.

Conclusione

In questo tutorial, abbiamo esplorato come lavorare con i grafici usando 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?

È possibile aggiungere più serie a un grafico utilizzandochart.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 impostazione del codice formato desiderato utilizzandogetNumberFormat().setFormatCode().

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

È possibile personalizzare le proprietà dell’asse come tipo, segni di spunta, etichette e altro ancora accedendo aChartAxis proprietà comesetCategoryType(), setCrosses() , EsetMajorTickMark().

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

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

Come posso nascondere un asse di un grafico?

È possibile nascondere un asse del grafico impostandosetHidden(true) proprietà dell’asse.