Personnaliser les légendes de graphiques dans les présentations avec Python

Vue d’ensemble

Aspose.Slides for Python offre un contrôle complet sur les légendes de graphiques afin que vous puissiez rendre les libellés de données clairs et prêts pour la présentation. Vous pouvez afficher ou masquer la légende, choisir sa position sur la diapositive et ajuster la disposition pour éviter le chevauchement avec la zone du tracé. L’API vous permet de styliser le texte et les marqueurs, d’ajuster finement les marges et l’arrière‑plan, ainsi que de formater les bordures et les remplissages pour correspondre à votre thème. Les développeurs peuvent également accéder aux entrées de légende individuelles pour les renommer ou les filtrer, garantissant que seules les séries les plus pertinentes sont affichées. Avec ces possibilités, vos graphiques restent lisibles, cohérents et alignés sur les normes de conception de votre présentation.

Positionnement de la légende

Avec Aspose.Slides, vous pouvez rapidement contrôler où la légende du graphique apparaît et comment elle s’intègre à la mise en page de votre diapositive. Apprenez à placer la légende avec précision.

  1. Créez une instance de la classe Presentation.
  2. Obtenez une référence à la diapositive.
  3. Ajoutez un graphique à la diapositive.
  4. Définissez les propriétés de la légende.
  5. Enregistrez la présentation au format PPTX.

Dans l’exemple ci‑dessous, nous définissons la position et la taille de la légende du graphique :

import aspose.slides.charts as charts
import aspose.slides as slides

# Créer une instance de la classe Presentation.
with slides.Presentation() as presentation:

    # Obtenir une référence à la diapositive.
    slide = presentation.slides[0]

    # Ajouter un graphique à colonnes groupées à la diapositive.
    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 50, 50, 600, 300)

    # Définir les propriétés de la légende.
    chart.legend.x = 80 / chart.width
    chart.legend.y = 20 / chart.height
    chart.legend.width = 100 / chart.width
    chart.legend.height = 100 / chart.height

    # Enregistrer la présentation sur le disque.
    presentation.save("legend_positioning.pptx", slides.export.SaveFormat.PPTX)

Définir la taille de police de la légende

La légende d’un graphique doit être aussi lisible que les données qu’elle explique. Cette section montre comment ajuster la taille de police de la légende afin d’harmoniser la typographie de votre présentation et d’améliorer l’accessibilité.

  1. Instanciez la classe Presentation.
  2. Créez un graphique.
  3. Définissez la taille de police.
  4. Enregistrez la présentation sur le disque.
import aspose.slides.charts as charts
import aspose.slides as slides

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 50, 50, 600, 400)
    chart.legend.text_format.portion_format.font_height = 20

    presentation.save("font_size.pptx", slides.export.SaveFormat.PPTX)

Définir la taille de police pour une entrée de légende

Aspose.Slides vous permet d’ajuster l’apparence des légendes de graphiques en formatant les entrées individuelles. L’exemple ci‑dessous montre comment cibler un élément de légende spécifique et définir ses propriétés sans modifier le reste de la légende.

  1. Instanciez la classe Presentation.
  2. Créez un graphique.
  3. Accédez à une entrée de légende.
  4. Définissez les propriétés de l’entrée.
  5. Enregistrez la présentation sur le disque.
import aspose.slides.charts as charts
import aspose.slides as slides
import aspose.pydrawing as draw

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 50, 50, 600, 400)
    text_format = chart.legend.entries[1].text_format

    text_format.portion_format.font_bold = slides.NullableBool.TRUE
    text_format.portion_format.font_height = 20
    text_format.portion_format.font_italic = slides.NullableBool.TRUE
    text_format.portion_format.fill_format.fill_type = slides.FillType.SOLID
    text_format.portion_format.fill_format.solid_fill_color.color = draw.Color.blue

    presentation.save("legend_entry.pptx", slides.export.SaveFormat.PPTX)

FAQ

Puis‑je activer la légende afin que le graphique alloue automatiquement de l’espace au lieu de la superposer ?

Oui. Utilisez le mode non‑superposition (overlay = false) ; dans ce cas, la zone du tracé rétrécira pour accueillir la légende.

Puis‑je créer des libellés de légende multi‑lignes ?

Oui. Les libellés longs se renvoient automatiquement lorsqu’il n’y a pas assez d’espace ; les sauts de ligne forcés sont pris en charge via les caractères de nouvelle ligne dans le nom de la série.

Comment faire en sorte que la légende suive le schéma de couleurs du thème de la présentation ?

Ne définissez pas de couleurs/remplissages/polices explicites pour la légende ou son texte. Ils hériteront alors du thème et se mettront à jour correctement lorsque le design changera.