Personnaliser les graphiques en secteurs dans les présentations avec Java
Vue d’ensemble
Cet article explique comment travailler avec les graphiques en secteurs dans Aspose.Slides. Il montre comment configurer les options de tracé secondaire pour les graphiques Pie of Pie et Bar of Pie, et comment activer la coloration automatique des parts pour un graphique en secteur standard.
Les exemples se concentrent sur les tâches de personnalisation des graphiques, telles que l’ajout d’un graphique à une diapositive, l’ajustement des paramètres de séries et d’étiquettes, le remplacement des données de graphique par défaut par des catégories et des valeurs personnalisées, et l’enregistrement de la présentation mise à jour.
Options de tracé secondaire pour les graphiques Pie of Pie et Bar of Pie
Aspose.Slides for Java prend en charge les options de tracé secondaire pour les graphiques Pie of Pie et Bar of Pie. Ces options contrôlent la taille du tracé secondaire et la façon dont les points de données sont répartis entre les deux tracés.
L’exemple suivant crée un graphique Pie of Pie dans une nouvelle présentation et affiche les valeurs des points de données sous forme d’étiquettes. La méthode setSecondPieSize définit la taille du tracé secondaire à 149 % du tracé principal. setPieSplitBy sélectionne un découpage basé sur le pourcentage, et setPieSplitPosition fixe le seuil à 53 %.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.PieOfPie, 50, 50, 500, 400);
IChartSeries series = chart.getChartData().getSeries().get_Item(0);
// Afficher les valeurs et configurer le tracé secondaire.
series.getLabels().getDefaultDataLabelFormat().setShowValue(true);
IChartSeriesGroup seriesGroup = series.getParentSeriesGroup();
seriesGroup.setSecondPieSize(149);
seriesGroup.setPieSplitBy(PieSplitType.ByPercentage);
seriesGroup.setPieSplitPosition(53);
presentation.save("pie_of_pie.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Sélectionner les catégories pour le tracé secondaire
Utilisez le découpage personnalisé lorsque vous souhaitez regrouper des catégories spécifiques dans le tracé secondaire, indépendamment de leurs valeurs en pourcentage. Par exemple, un rapport de ventes pourrait présenter Online et Events ensemble afin que les lecteurs puissent comparer ces deux canaux, même s’ils représentent 35 % et 10 % des ventes totales.
Appelez setPieSplitBy avec PieSplitType.Custom et sélectionnez les points via getPieSplitCustomPoints. La méthode add de la collection accepte un indice zéro‑basé dans la série ; utilisez addItem pour ajouter un objet de point de données. Dans cet exemple, l’indice 1 sélectionne Online, et le point à l’indice 3 sélectionne Events. Partners est également ajouté temporairement, puis exclu à l’aide de removeItem.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.PieOfPie, 50, 50, 600, 200);
// Remplacer les données par défaut par les ventes par canal.
IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
chart.getChartData().getSeries().clear();
chart.getChartData().getCategories().clear();
String[] categoryNames = { "Retail", "Online", "Partners", "Events" };
int[] values = { 40, 35, 15, 10 };
IChartDataCell seriesNameCell = workbook.getCell(0, 0, 1, "Sales");
IChartSeries series = chart.getChartData().getSeries().add(seriesNameCell, chart.getType());
for (int i = 0; i < categoryNames.length; i++) {
IChartDataCell categoryCell = workbook.getCell(0, i + 1, 0, categoryNames[i]);
chart.getChartData().getCategories().add(categoryCell);
IChartDataCell valueCell = workbook.getCell(0, i + 1, 1, values[i]);
series.getDataPoints().addDataPointForPieSeries(valueCell);
}
series.getLabels().getDefaultDataLabelFormat().setShowValue(true);
IChartSeriesGroup seriesGroup = series.getParentSeriesGroup();
seriesGroup.setPieSplitBy(PieSplitType.Custom);
seriesGroup.setColorVaried(true);
// Sélectionner Online par son indice zéro basé et Events par son objet de point de données.
seriesGroup.getPieSplitCustomPoints().add(1);
seriesGroup.getPieSplitCustomPoints().addItem(series.getDataPoints().get_Item(3));
// Exclure Partners de la sélection sans supprimer ses données sources.
seriesGroup.getPieSplitCustomPoints().add(2);
seriesGroup.getPieSplitCustomPoints().removeItem(series.getDataPoints().get_Item(2));
presentation.save("pie_of_pie_custom.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Online (35) et Events (10) apparaissent comme des parts séparées dans le tracé secondaire. Dans le tracé principal, ils sont représentés par une part combinée d’une valeur de 45, aux côtés de Retail (40) et Partners (15). Supprimer Partners de la sélection personnalisée le maintient dans le tracé principal ; cela ne supprime pas la catégorie ni sa valeur des données sources du graphique.
L’image suivante montre la présentation enregistrée dans PowerPoint :
Définir les couleurs automatiques des parts du graphique en secteur
Aspose.Slides for Java peut attribuer automatiquement des couleurs différentes aux parts d’un graphique en secteur. L’exemple suivant crée un graphique en secteur avec un titre centré et remplace les données par défaut par trois catégories trimestrielles et leurs valeurs. La méthode setShowValue affiche les valeurs 20, 50 et 30 sous forme d’étiquettes, tandis que setColorVaried active une couleur distincte pour chaque part.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.Pie, 100, 100, 400, 400);
// Ajouter un titre de graphique centré.
chart.getChartTitle().addTextFrameForOverriding("Sample Title");
chart.getChartTitle().getTextFrameForOverriding().getTextFrameFormat().setCenterText(NullableBool.True);
chart.getChartTitle().setHeight(20);
chart.setTitle(true);
// Remplacer les données par défaut en utilisant la première feuille de calcul.
IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
int worksheetIndex = 0;
chart.getChartData().getSeries().clear();
chart.getChartData().getCategories().clear();
String[] categoryNames = { "First Qtr", "2nd Qtr", "3rd Qtr" };
int[] values = { 20, 50, 30 };
IChartDataCell seriesNameCell = workbook.getCell(worksheetIndex, 0, 1, "Series 1");
IChartSeries series = chart.getChartData().getSeries().add(seriesNameCell, chart.getType());
for (int i = 0; i < categoryNames.length; i++) {
IChartDataCell categoryCell = workbook.getCell(worksheetIndex, i + 1, 0, categoryNames[i]);
chart.getChartData().getCategories().add(categoryCell);
IChartDataCell valueCell = workbook.getCell(worksheetIndex, i + 1, 1, values[i]);
series.getDataPoints().addDataPointForPieSeries(valueCell);
}
// Afficher les valeurs et affecter des couleurs différentes aux parts.
series.getLabels().getDefaultDataLabelFormat().setShowValue(true);
series.getParentSeriesGroup().setColorVaried(true);
presentation.save("pie.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
FAQ
Les variantes Pie of Pie et Bar of Pie sont‑elles prises en charge ?
Oui, la bibliothèque prend en charge un tracé secondaire pour les graphiques en secteur, y compris les types Pie of Pie et Bar of Pie.
Puis‑je exporter uniquement le graphique en tant qu’image (par exemple, PNG) ?
Oui, vous pouvez exporter le graphique lui‑même en tant qu’image (comme PNG) sans exporter l’ensemble de la présentation.