Gérer SmartArt dans les présentations PowerPoint à l'aide de Python

Aperçu

Ce guide montre comment créer et manipuler SmartArt dans Aspose.Slides pour Python. Vous apprendrez à extraire le texte de SmartArt (y compris le contenu TextFrame à l’intérieur des formes de nœuds), à ajouter SmartArt aux diapositives et à changer sa disposition, à détecter et gérer les nœuds masqués, à configurer les dispositions d’organigramme, et à créer des organigrammes d’images — le tout avec des exemples Python concis, prêts à copier‑coller, qui ouvrent une Presentation, travaillent avec les diapositives et les nœuds SmartArt, et enregistrent les résultats au format PPTX.

Obtenir le texte de SmartArt

La propriété text_frame du SmartArtShape vous permet de récupérer tout le texte d’une forme SmartArt — pas seulement le texte contenu dans ses nœuds. Le code d’exemple suivant montre comment obtenir le texte d’un nœud SmartArt.

import aspose.slides as slides

with slides.Presentation("SmartArt.pptx") as presentation:
    slide = presentation.slides[0]
    smart_art = slide.shapes[0]

    for smart_art_node in smart_art.all_nodes:
        for node_shape in smart_art_node.shapes:
            if node_shape.text_frame is not None:
                print(node_shape.text_frame.text)

Modifier le type de disposition de SmartArt

Pour modifier le type de disposition de SmartArt, suivez ces étapes :

1. Créez une instance de la classe Presentation.
2. Obtenez une référence à une diapositive par son indice.
3. Ajoutez une forme SmartArt avec la disposition BASIC_BLOCK_LIST.
4. Changez sa disposition en BASIC_PROCESS.
5. Enregistrez la présentation sous forme de fichier PPTX.

import aspose.slides as slides
import aspose.slides.smartart as smartart

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

    # Ajouter une forme SmartArt avec la mise en page BASIC_BLOCK_LIST.
    smart = slide.shapes.add_smart_art(10, 10, 400, 300, smartart.SmartArtLayoutType.BASIC_BLOCK_LIST)

    # Modifier le type de mise en page en BASIC_PROCESS.
    smart.layout = smartart.SmartArtLayoutType.BASIC_PROCESS

    # Enregistrer la présentation.
    presentation.save("ChangedSmartArtLayout.pptx", slides.export.SaveFormat.PPTX)

Vérifier la propriété masquée de SmartArt

La propriété SmartArtNode.is_hidden renvoie True si le nœud est masqué dans le modèle de données. Pour vérifier si un nœud SmartArt est masqué, suivez ces étapes :

1. Créez une instance de la classe Presentation.
2. Ajoutez une forme SmartArt avec la disposition RADIAL_CYCLE.
3. Ajoutez un nœud au SmartArt.
4. Vérifiez la propriété is_hidden.

import aspose.slides as slides
import aspose.slides.smartart as smartart

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

    # Ajouter une forme SmartArt avec la mise en page RADIAL_CYCLE.
    smart = slide.shapes.add_smart_art(10, 10, 400, 300, smartart.SmartArtLayoutType.RADIAL_CYCLE)

    # Ajouter un nœud au SmartArt.
    node = smart.all_nodes.add_node()

    # Vérifier la propriété is_hidden.
    if node.is_hidden:
        print("The node is hidden.")

Obtenir ou définir le type d’organigramme

La propriété SmartArtNode.organization_chart_layout permet d’obtenir ou de définir le type d’organigramme associé au nœud actuel. Pour obtenir ou définir ce type, suivez ces étapes :

1. Créez une instance de la classe Presentation.
2. Ajoutez une forme SmartArt à la diapositive.
3. Obtenez ou définissez le type d’organigramme.
4. Enregistrez la présentation sous forme de fichier PPTX.

import aspose.slides as slides
import aspose.slides.smartart as smartart

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

    # Ajouter une forme SmartArt avec la mise en page ORGANIZATION_CHART.
    smart = slide.shapes.add_smart_art(10, 10, 400, 300, smartart.SmartArtLayoutType.ORGANIZATION_CHART)

    # Définir le type d'organigramme.
    smart.nodes[0].organization_chart_layout = smartart.OrganizationChartLayoutType.LEFT_HANGING

    # Enregistrer la présentation.
    presentation.save("OrganizationChartLayout.pptx", slides.export.SaveFormat.PPTX)

Créer un organigramme d’image

Aspose.Slides pour Python fournit une API simple pour créer facilement des organigrammes d’image. Pour créer un organigramme sur une diapositive :

1. Créez une instance de la classe Presentation.
2. Obtenez une référence à la diapositive par son indice.
3. Ajoutez un graphique avec les données par défaut du type souhaité.
4. Enregistrez la présentation modifiée sous forme de fichier PPTX.

import aspose.slides as slides
import aspose.slides.smartart as smartart

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

    smart_art = slide.shapes.add_smart_art(0, 0, 400, 400, smartart.SmartArtLayoutType.PICTURE_ORGANIZATION_CHART)
    
    presentation.save("OrganizationChart.pptx", slides.export.SaveFormat.PPTX)

FAQ

SmartArt prend‑il en charge le miroir/inversion pour les langues RTL ?

Oui. La propriété is_reversed inverse la direction du diagramme (LTR/RTL) si le type SmartArt sélectionné prend en charge l’inversion.

Comment copier SmartArt sur la même diapositive ou dans une autre présentation tout en conservant le formatage ?

Vous pouvez cloner la forme SmartArt via la collection de formes (ShapeCollection.add_clone) ou cloner la diapositive entière contenant cette forme. Les deux approches conservent la taille, la position et le style.

Comment rendre SmartArt en image raster pour un aperçu ou une exportation web ?

Render the slide (ou toute la présentation) en PNG/JPEG via l’API qui convertit les diapositives/pré­sentations en images — SmartArt sera dessiné comme partie de la diapositive.

Comment sélectionner programmatiquement un SmartArt spécifique sur une diapositive lorsqu’il y en a plusieurs ?

Une pratique courante consiste à utiliser le texte alternatif (Alt Text) ou un nom et à rechercher la forme par cet attribut dans Slide.shapes, puis à vérifier le type pour confirmer qu’il s’agit bien d’un SmartArt. La documentation décrit les techniques typiques pour trouver et travailler avec les formes.