Utilisation des graphiques dans Aspose.Words pour Java

Introduction à l’utilisation des graphiques dans Aspose.Words pour Java

Dans ce didacticiel, nous allons découvrir comment travailler avec des graphiques à l’aide d’Aspose.Words pour Java. Vous apprendrez à créer différents types de graphiques, à personnaliser les propriétés des axes, à formater les étiquettes de données, et bien plus encore. Plongeons-nous dans le vif du sujet !

Créer un graphique linéaire

Pour créer un graphique linéaire, utilisez le code suivant :

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");

// Supprimer la série générée par défaut.
chart.getSeries().clear();

// Ajout d'une série avec des données et des étiquettes de données.
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%");

// Ou liez le code de format à une cellule source.
series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true);

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

Créer d’autres types de graphiques

Vous pouvez créer différents types de graphiques, comme des graphiques à colonnes, à aires, à bulles, à nuages de points, etc., en utilisant des techniques similaires. Voici un exemple d’insertion d’un graphique à colonnes simple :

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

// Supprimer la série générée par défaut.
chart.getSeries().clear();

// Création de catégories et ajout de données.
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");

Personnalisation des propriétés des axes

Vous pouvez personnaliser les propriétés de l’axe, comme modifier le type d’axe, définir des graduations, formater les étiquettes, etc. Voici un exemple de définition des propriétés de l’axe XY :

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

// Effacez la série par défaut et ajoutez vos données.

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

// Modifiez l'axe X pour qu'il soit une catégorie au lieu d'une date.
xAxis.setCategoryType(AxisCategoryType.CATEGORY);
xAxis.setCrosses(AxisCrosses.CUSTOM);
xAxis.setCrossesAt(3.0); // Mesuré en unités d'affichage de l'axe Y (centaines).
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");

Formatage des étiquettes de données

Vous pouvez formater les étiquettes de données avec différents formats de nombres. Voici un exemple :

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

// Effacez la série par défaut et ajoutez vos données.

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

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

Personnalisations supplémentaires des graphiques

Vous pouvez personnaliser davantage vos graphiques en ajustant les limites, les unités d’intervalle entre les étiquettes, en masquant les axes des graphiques, etc. Explorez les extraits de code fournis pour en savoir plus sur ces options.

Conclusion

Dans ce didacticiel, nous avons découvert comment travailler avec des graphiques à l’aide d’Aspose.Words pour Java. Vous avez appris à créer différents types de graphiques, à personnaliser les propriétés des axes, à formater les étiquettes de données, etc. Aspose.Words pour Java fournit des outils puissants pour ajouter des représentations visuelles des données à vos documents, améliorant ainsi la façon dont vous présentez les informations.

FAQ

Comment puis-je ajouter plusieurs séries à un graphique ?

Vous pouvez ajouter plusieurs séries à un graphique à l’aide de lachart.getSeries().add() méthode. Assurez-vous de spécifier le nom de la série, les catégories et les valeurs de données.

Comment puis-je formater des étiquettes de données avec des formats numériques personnalisés ?

Vous pouvez formater les étiquettes de données en accédant à l’DataLabels propriétés d’une série et définition du code de format souhaité à l’aide degetNumberFormat().setFormatCode().

Comment personnaliser les propriétés des axes dans un graphique ?

Vous pouvez personnaliser les propriétés de l’axe telles que le type, les graduations, les étiquettes, etc. en accédant à l’ChartAxis propriétés commesetCategoryType(), setCrosses() , etsetMajorTickMark().

Comment puis-je créer d’autres types de graphiques comme des graphiques en nuage de points ou en aires ?

Vous pouvez créer différents types de graphiques en spécifiant lesChartType lors de l’insertion du graphique à l’aide debuilder.insertChart(ChartType.TYPE, width, height).

Comment puis-je masquer un axe de graphique ?

Vous pouvez masquer un axe de graphique en définissant lesetHidden(true) propriété de l’axe.