Ajouter une légende de beignet dans les diapositives Java

Introduction à l’ajout d’une légende en forme de beignet dans les diapositives Java à l’aide d’Aspose.Slides pour Java

Dans ce didacticiel, nous vous guiderons tout au long du processus d’ajout d’une légende en forme de beignet à une diapositive en Java à l’aide d’Aspose.Slides pour Java. Une légende en forme de beignet est un élément de graphique qui peut être utilisé pour mettre en évidence des points de données spécifiques dans un graphique en forme de beignet. Nous vous fournirons des instructions étape par étape et un code source complet pour votre commodité.

Conditions préalables

Avant de commencer, assurez-vous que les conditions préalables suivantes sont remplies :

  1. Environnement de développement Java
  2. Aspose.Slides pour la bibliothèque Java
  3. Environnement de développement intégré (IDE) comme Eclipse ou IntelliJ IDEA
  4. Une présentation PowerPoint dans laquelle vous souhaitez ajouter la légende Donut

Étape 1 : Configurez votre projet Java

  1. Créez un nouveau projet Java dans l’EDI de votre choix.
  2. Ajoutez la bibliothèque Aspose.Slides pour Java à votre projet en tant que dépendance.

Étape 2 : initialiser la présentation

Pour commencer, vous devrez initialiser une présentation PowerPoint et créer une diapositive dans laquelle vous souhaitez ajouter la légende Donut. Voici le code pour y parvenir :

String dataDir = "Your Document Directory";
Presentation pres = new Presentation(dataDir + "testc.pptx");
ISlide slide = pres.getSlides().get_Item(0);

Assurez-vous de remplacer"Your Document Directory" avec le chemin réel vers votre fichier de présentation PowerPoint.

Étape 3 : Créer un graphique en anneau

Vous allez ensuite créer un graphique en anneau sur la diapositive. Vous pouvez personnaliser la position et la taille du graphique selon vos besoins. Voici le code pour ajouter un graphique Donut :

IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false);

Étape 4 : Personnaliser le graphique en beignet

Il est maintenant temps de personnaliser le graphique Donut. Nous définirons diverses propriétés telles que la suppression de la légende, la configuration de la taille du trou et l’ajustement du premier angle de coupe. Voici le code :

IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook();
chart.getChartData().getSeries().clear();
chart.getChartData().getCategories().clear();
chart.setLegend(false);
int seriesIndex = 0;
while (seriesIndex < 15) {
    IChartSeries series = chart.getChartData().getSeries().add(workBook.getCell(0, 0, seriesIndex + 1, "SERIES " + seriesIndex), chart.getType());
    series.setExplosion(0);
    series.getParentSeriesGroup().setDoughnutHoleSize((byte) 20);
    series.getParentSeriesGroup().setFirstSliceAngle(351);
    seriesIndex++;
}

Cet extrait de code définit les propriétés du graphique Donut. Vous pouvez ajuster les valeurs pour répondre à vos besoins spécifiques.

Étape 5 : ajouter des données au graphique en anneau

Maintenant, ajoutons des données au graphique Donut. Nous personnaliserons également l’apparence des points de données. Voici le code pour réaliser cela :

int categoryIndex = 0;
while (categoryIndex < 15) {
    chart.getChartData().getCategories().add(workBook.getCell(0, categoryIndex + 1, 0, "CATEGORY " + categoryIndex));
    int i = 0;
    while (i < chart.getChartData().getSeries().size()) {
        IChartSeries iCS = chart.getChartData().getSeries().get_Item(i);
        IChartDataPoint dataPoint = iCS.getDataPoints().addDataPointForDoughnutSeries(workBook.getCell(0, categoryIndex + 1, i + 1, 1));
        dataPoint.getFormat().getFill().setFillType(FillType.Solid);
        // Personnalisez l'apparence des points de données ici
        i++;
    }
    categoryIndex++;
}

Dans ce code, nous ajoutons des catégories et des points de données au graphique Donut. Vous pouvez personnaliser davantage l’apparence des points de données selon vos besoins.

Étape 6 : Enregistrez la présentation

Enfin, n’oubliez pas de sauvegarder votre présentation après avoir ajouté la légende Donut. Voici le code pour enregistrer la présentation :

pres.save(dataDir + "chart.pptx", SaveFormat.Pptx);

Assurez-vous de remplacer"chart.pptx" avec le nom de fichier souhaité.

Toutes nos félicitations! Vous avez ajouté avec succès une légende en forme de beignet à une diapositive Java à l’aide d’Aspose.Slides pour Java. Vous pouvez maintenant exécuter votre application Java pour générer la présentation PowerPoint avec le graphique en anneau et la légende.

Code source complet pour ajouter une légende de beignet dans les diapositives Java

String dataDir = "Your Document Directory";
Presentation pres = new Presentation(dataDir + "testc.pptx");
ISlide slide = pres.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false);
IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook();
chart.getChartData().getSeries().clear();
chart.getChartData().getCategories().clear();
chart.setLegend(false);
int seriesIndex = 0;
while (seriesIndex < 15)
{
	IChartSeries series = chart.getChartData().getSeries().add(workBook.getCell(0, 0, seriesIndex + 1, "SERIES " + seriesIndex), chart.getType());
	series.setExplosion(0);
	series.getParentSeriesGroup().setDoughnutHoleSize((byte) 20);
	series.getParentSeriesGroup().setFirstSliceAngle(351);
	seriesIndex++;
}
int categoryIndex = 0;
while (categoryIndex < 15)
{
	chart.getChartData().getCategories().add(workBook.getCell(0, categoryIndex + 1, 0, "CATEGORY " + categoryIndex));
	int i = 0;
	while (i < chart.getChartData().getSeries().size())
	{
		IChartSeries iCS = chart.getChartData().getSeries().get_Item(i);
		IChartDataPoint dataPoint = iCS.getDataPoints().addDataPointForDoughnutSeries(workBook.getCell(0, categoryIndex + 1, i + 1, 1));
		dataPoint.getFormat().getFill().setFillType(FillType.Solid);
		dataPoint.getFormat().getLine().getFillFormat().setFillType(FillType.Solid);
		dataPoint.getFormat().getLine().getFillFormat().getSolidFillColor().setColor(Color.WHITE);
		dataPoint.getFormat().getLine().setWidth(1);
		dataPoint.getFormat().getLine().setStyle(LineStyle.Single);
		dataPoint.getFormat().getLine().setDashStyle(LineDashStyle.Solid);
		if (i == chart.getChartData().getSeries().size() - 1)
		{
			IDataLabel lbl = dataPoint.getLabel();
			lbl.getTextFormat().getTextBlockFormat().setAutofitType(TextAutofitType.Shape);
			lbl.getDataLabelFormat().getTextFormat().getPortionFormat().setFontBold(NullableBool.True);
			lbl.getDataLabelFormat().getTextFormat().getPortionFormat().setLatinFont(new FontData("DINPro-Bold"));
			lbl.getDataLabelFormat().getTextFormat().getPortionFormat().setFontHeight(12);
			lbl.getDataLabelFormat().getTextFormat().getPortionFormat().getFillFormat().setFillType(FillType.Solid);
			lbl.getDataLabelFormat().getTextFormat().getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.LIGHT_GRAY);
			lbl.getDataLabelFormat().getFormat().getLine().getFillFormat().getSolidFillColor().setColor(Color.WHITE);
			lbl.getDataLabelFormat().setShowValue(false);
			lbl.getDataLabelFormat().setShowCategoryName(true);
			lbl.getDataLabelFormat().setShowSeriesName(false);
			//lbl.getDataLabelFormat().setShowLabelAsDataCallout(true);
			lbl.getDataLabelFormat().setShowLeaderLines(true);
			lbl.getDataLabelFormat().setShowLabelAsDataCallout(false);
			chart.validateChartLayout();
			lbl.setX(lbl.getX() + (float) 0.5);
			lbl.setY(lbl.getY() + (float) 0.5);
		}
		i++;
	}
	categoryIndex++;
}
pres.save(dataDir + "chart.pptx", SaveFormat.Pptx);

Conclusion

Dans ce didacticiel, nous avons couvert le processus d’ajout d’une légende en forme de beignet à une diapositive Java à l’aide d’Aspose.Slides pour Java. Vous avez appris à créer un graphique en anneau, à personnaliser son apparence et à ajouter des points de données. N’hésitez pas à améliorer davantage vos présentations avec cette puissante bibliothèque et à explorer davantage d’options de création de graphiques.

FAQ

Comment puis-je modifier l’apparence de la légende du beignet ?

Vous pouvez personnaliser l’apparence de la légende Donut en modifiant les propriétés des points de données dans le graphique. Dans le code fourni, vous pouvez voir comment définir la couleur de remplissage, la couleur de ligne, le style de police et d’autres attributs des points de données.

Puis-je ajouter plus de points de données au graphique Donut ?

Oui, vous pouvez ajouter autant de points de données que nécessaire au graphique Donut. Étendez simplement les boucles du code où les catégories et les points de données sont ajoutés, et fournissez les données et le formatage appropriés.

Comment puis-je ajuster la position et la taille du graphique Donut sur la diapositive ?

Vous pouvez changer la position et la taille du graphique Donut en modifiant les paramètres dans leaddChart méthode. Les quatre nombres de cette méthode correspondent respectivement aux coordonnées X et Y du coin supérieur gauche du graphique ainsi qu’à sa largeur et sa hauteur.

Ajouter une erreur personnalisée dans les diapositives Java Ajouter des barres d'erreur dans les diapositives Java