Gérer les graphiques de propriétés dans Java Slides

Introduction à la gestion des propriétés et des graphiques dans les diapositives Java à l’aide d’Aspose.Slides

Dans ce didacticiel, nous explorerons comment gérer les propriétés et créer des graphiques dans des diapositives Java à l’aide d’Aspose.Slides. Aspose.Slides est une puissante API Java pour travailler avec des présentations PowerPoint. Nous allons parcourir le processus étape par étape, y compris des exemples de code source.

Conditions préalables

Avant de commencer, assurez-vous que la bibliothèque Aspose.Slides pour Java est installée et configurée dans votre projet. Vous pouvez le télécharger depuisici.

Ajout d’un graphique à une diapositive

Pour ajouter un graphique à une diapositive, procédez comme suit :

  1. Importez les classes nécessaires et créez une instance de la classe Présentation.
// Créer une instance de la classe Présentation
Presentation presentation = new Presentation();
  1. Accédez à la diapositive dans laquelle vous souhaitez ajouter le graphique. Dans cet exemple, nous accédons à la première diapositive.
// Accéder à la première diapositive
ISlide slide = presentation.getSlides().get_Item(0);
  1. Ajoutez un graphique avec des données par défaut. Dans ce cas, nous ajoutons un graphique StackedColumn3D.
// Ajouter un graphique avec les données par défaut
IChart chart = slide.getShapes().addChart(ChartType.StackedColumn3D, 0, 0, 500, 500);

Définition des données du graphique

Pour définir les données du graphique, nous devons créer un classeur de données graphiques et ajouter des séries et des catégories. Suivez ces étapes:

  1. Définissez l’index de la feuille de données du graphique.
// Définition de l'index de la feuille de données du graphique
int defaultWorksheetIndex = 0;
  1. Obtenez le classeur de données graphiques.
// Obtenir la feuille de calcul des données du graphique
IChartDataWorkbook fact = chart.getChartData().getChartDataWorkbook();
  1. Ajoutez une série au graphique. Dans cet exemple, nous ajoutons deux séries nommées « Série 1 » et « Série 2 ».
chart.getChartData().getSeries().add(fact.getCell(defaultWorksheetIndex, 0, 1, "Series 1"), chart.getType());
chart.getChartData().getSeries().add(fact.getCell(defaultWorksheetIndex, 0, 2, "Series 2"), chart.getType());
  1. Ajoutez des catégories au graphique. Ici, nous ajoutons trois catégories.
chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 1, 0, "Category 1"));
chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 2, 0, "Category 2"));
chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 3, 0, "Category 3"));

Définition des propriétés de rotation 3D

Maintenant, définissons les propriétés de rotation 3D du graphique :

  1. Définissez les axes à angle droit.
chart.getRotation3D().setRightAngleAxes(true);
  1. Définissez les angles de rotation pour les axes X et Y. Dans cet exemple, nous faisons pivoter X de 40 degrés et Y de 270 degrés.
chart.getRotation3D().setRotationX((byte) 40);
chart.getRotation3D().setRotationY(270);
  1. Réglez le pourcentage de profondeur sur 150.
chart.getRotation3D().setDepthPercents(150);

Remplissage des données de série

  1. Prenez la deuxième série de graphiques et remplissez-la avec des points de données.
IChartSeries series = chart.getChartData().getSeries().get_Item(1);

// Remplir les données de la série
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 1, 1, 20));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 2, 1, 50));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 3, 1, 30));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 1, 2, 30));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 2, 2, 10));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 3, 2, 60));

Ajustement du chevauchement

  1. Définissez la valeur de chevauchement pour les séries. Par exemple, vous pouvez le définir sur 100 pour éviter tout chevauchement.
series.getParentSeriesGroup().setOverlap((byte) 100);

Sauvegarde de la présentation

Enfin, enregistrez la présentation sur le disque.

presentation.save(dataDir + "Rotation3D_out.pptx", SaveFormat.Pptx);

C’est ça! Vous avez créé avec succès un histogramme empilé 3D avec des propriétés personnalisées à l’aide d’Aspose.Slides en Java.

Code source complet pour gérer les graphiques de propriétés dans les diapositives Java

// Le chemin d'accès au répertoire des documents.
String dataDir = "Your Document Directory";
// Créer une instance de la classe Présentation
Presentation presentation = new Presentation();
// Accéder à la première diapositive
ISlide slide = presentation.getSlides().get_Item(0);
// Ajouter un graphique avec les données par défaut
IChart chart = slide.getShapes().addChart(ChartType.StackedColumn3D, 0, 0, 500, 500);
// Définition de l'index de la feuille de données du graphique
int defaultWorksheetIndex = 0;
// Obtenir la feuille de calcul des données du graphique
IChartDataWorkbook fact = chart.getChartData().getChartDataWorkbook();
// Ajouter une série
chart.getChartData().getSeries().add(fact.getCell(defaultWorksheetIndex, 0, 1, "Series 1"), chart.getType());
chart.getChartData().getSeries().add(fact.getCell(defaultWorksheetIndex, 0, 2, "Series 2"), chart.getType());
// Ajouter des catégories
chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 1, 0, "Caetegoty 1"));
chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 2, 0, "Caetegoty 2"));
chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 3, 0, "Caetegoty 3"));
// Définir les propriétés de Rotation3D
chart.getRotation3D().setRightAngleAxes(true);
chart.getRotation3D().setRotationX((byte) 40);
chart.getRotation3D().setRotationY(270);
chart.getRotation3D().setDepthPercents(150);
// Prendre la deuxième série de graphiques
IChartSeries series = chart.getChartData().getSeries().get_Item(1);
// Remplir maintenant les données de série
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 1, 1, 20));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 2, 1, 50));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 3, 1, 30));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 1, 2, 30));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 2, 2, 10));
series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 3, 2, 60));
// Définir la valeur de chevauchement
series.getParentSeriesGroup().setOverlap((byte) 100);
// Écrire la présentation sur le disque
presentation.save(dataDir + "Rotation3D_out.pptx", SaveFormat.Pptx);

Conclusion

Dans ce didacticiel, nous avons plongé dans le monde de la gestion des propriétés et de la création de graphiques dans des diapositives Java à l’aide d’Aspose.Slides. Aspose.Slides est une API Java robuste qui permet aux développeurs de travailler efficacement avec des présentations PowerPoint. Nous avons couvert les étapes essentielles et fourni des exemples de code source pour vous guider tout au long du processus.

FAQ

Comment puis-je changer le type de graphique ?

Vous pouvez changer le type de graphique en modifiant leChartType paramètre lors de l’ajout du graphique. Reportez-vous à la documentation Aspose.Slides pour connaître les types de graphiques disponibles.

Puis-je personnaliser les couleurs du graphique ?

Oui, vous pouvez personnaliser les couleurs du graphique en définissant les propriétés de remplissage des points de données ou des catégories de séries.

Comment ajouter plus de points de données à une série ?

Vous pouvez ajouter plus de points de données à une série en utilisant l’outilseries.getDataPoints().addDataPointForBarSeries() méthode et en spécifiant la cellule contenant la valeur des données.

Comment puis-je définir un angle de rotation différent ?

Pour définir un angle de rotation différent pour les axes X et Y, utilisezchart.getRotation3D().setRotationX() etchart.getRotation3D().setRotationY() avec les valeurs d’angle souhaitées.

Quelles autres propriétés 3D puis-je personnaliser ?

Vous pouvez explorer d’autres propriétés 3D du graphique, telles que la profondeur, la perspective et l’éclairage, en vous référant à la documentation Aspose.Slides.