Personnaliser les graphiques circulaires dans les présentations avec Python via Java

À propos de cette page

Créer et personnaliser des graphiques circulaires en Python via Java avec Aspose.Slides. Configurer les tracés secondaires, afficher les libellés de données et appliquer des couleurs automatiques aux parts dans PowerPoint.

Vue d’ensemble

Cet article explique comment travailler avec les graphiques circulaires 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 circulaire standard.

Les exemples se concentrent sur des tâches de personnalisation de graphiques telles que l’ajout d’un graphique à une diapositive, le réglage des séries et des paramètres d’étiquettes, le remplacement des données de graphique par défaut par des catégories et 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 Python via 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 manière 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 en tant qu’étiquettes. La méthode setSecondPieSize définit la taille du tracé secondaire à 149% du tracé principal. setPieSplitBy sélectionne le fractionnement basé sur le pourcentage, et setPieSplitPosition fixe le seuil à 53%.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ChartType, PieSplitType, Presentation, SaveFormat

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    chart = slide.getShapes().addChart(ChartType.PieOfPie, 50, 50, 500, 400)
    series = chart.getChartData().getSeries().get_Item(0)

    # Afficher les valeurs et configurer le tracé secondaire.
    series.getLabels().getDefaultDataLabelFormat().setShowValue(True)
    series_group = series.getParentSeriesGroup()
    series_group.setSecondPieSize(149)
    series_group.setPieSplitBy(PieSplitType.ByPercentage)
    series_group.setPieSplitPosition(53)

    presentation.save("pie_of_pie.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Sélectionner les catégories pour le tracé secondaire

Utilisez le fractionnement 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 peut afficher 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 basé sur zéro dans la série ; utilisez addItem pour ajouter un objet 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 jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ChartType, PieSplitType, Presentation, SaveFormat

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    chart = slide.getShapes().addChart(ChartType.PieOfPie, 50, 50, 600, 200)

    # Remplacer les données par défaut par les ventes par canal.
    workbook = chart.getChartData().getChartDataWorkbook()
    chart.getChartData().getSeries().clear()
    chart.getChartData().getCategories().clear()
    category_names = ["Retail", "Online", "Partners", "Events"]
    values = [40, 35, 15, 10]
    series_name_cell = workbook.getCell(0, 0, 1, "Sales")
    series = chart.getChartData().getSeries().add(series_name_cell, chart.getType())

    for i in range(len(category_names)):
        category_cell = workbook.getCell(0, i + 1, 0, category_names[i])
        chart.getChartData().getCategories().add(category_cell)

        value_cell = workbook.getCell(0, i + 1, 1, jpype.JInt(values[i]))
        series.getDataPoints().addDataPointForPieSeries(value_cell)

    series.getLabels().getDefaultDataLabelFormat().setShowValue(True)
    series_group = series.getParentSeriesGroup()
    series_group.setPieSplitBy(PieSplitType.Custom)
    series_group.setColorVaried(True)

    # Sélectionner Online par son indice zéro et Events par son objet point de données.
    series_group.getPieSplitCustomPoints().add(1)
    series_group.getPieSplitCustomPoints().addItem(series.getDataPoints().get_Item(3))

    # Exclure Partners de la sélection sans supprimer ses données source.
    series_group.getPieSplitCustomPoints().add(2)
    series_group.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 :

Diagramme Pie of Pie avec Online et Events dans le tracé secondaire et leur valeur combinée de 45 dans le tracé principal

Définir les couleurs automatiques des parts du graphique circulaire

Aspose.Slides for Python via Java peut attribuer automatiquement des couleurs différentes aux parts d’un graphique circulaire. L’exemple suivant crée un graphique circulaire 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 en tant qu’étiquettes, tandis que setColorVaried active une couleur distincte pour chaque part.

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ChartType, NullableBool, Presentation, SaveFormat

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    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.
    workbook = chart.getChartData().getChartDataWorkbook()
    worksheet_index = 0
    chart.getChartData().getSeries().clear()
    chart.getChartData().getCategories().clear()
    category_names = ["First Qtr", "2nd Qtr", "3rd Qtr"]
    values = [20, 50, 30]
    series_name_cell = workbook.getCell(worksheet_index, 0, 1, "Series 1")
    series = chart.getChartData().getSeries().add(series_name_cell, chart.getType())

    for i in range(len(category_names)):
        category_cell = workbook.getCell(worksheet_index, i + 1, 0, category_names[i])
        chart.getChartData().getCategories().add(category_cell)

        value_cell = workbook.getCell(worksheet_index, i + 1, 1, jpype.JInt(values[i]))
        series.getDataPoints().addDataPointForPieSeries(value_cell)

    # Afficher les valeurs et attribuer 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 circulaires, y compris les types Pie of Pie et Bar of Pie.

Puis‑je exporter uniquement le graphique sous forme d’image (par exemple, PNG) ?

Oui, vous pouvez exporter le graphique lui‑même sous forme d’image (par exemple PNG) sans exporter la présentation entière.

Personnaliser les diagrammes en beignet dans les présentations avec Python via Java