Regrouper des formes de présentation avec Python

Vue d’ensemble

Le regroupement de formes vous permet de traiter plusieurs objets de dessin comme une seule unité afin de les déplacer, redimensionner, formater et transformer ensemble. Avec Aspose.Slides for Python, vous pouvez créer un GroupShape, ajouter et organiser des formes enfants à l’intérieur, puis enregistrer le résultat au format PPTX. Cet article montre comment ajouter une forme de groupe sur une diapositive et comment accéder aux métadonnées d’accessibilité telles que Alt Text à partir des formes du groupe, permettant une structure plus claire et des présentations plus riches et plus faciles à maintenir.

Ajouter des formes de groupe

Aspose.Slides prend en charge le travail avec les formes de groupe sur une diapositive. Cette fonctionnalité vous permet de créer des présentations plus riches en traitant plusieurs formes comme un seul objet. Vous pouvez ajouter de nouvelles formes de groupe, accéder à celles existantes, les remplir de formes enfants et lire ou modifier l’une de leurs propriétés. Pour ajouter une forme de groupe à une diapositive :

1. Créez une instance de la classe Presentation.
2. Obtenez une référence à une diapositive par son index.
3. Ajoutez un GroupShape à la diapositive.
4. Ajoutez des formes à la nouvelle forme de groupe.
5. Enregistrez la présentation modifiée au format PPTX.

L’exemple ci‑dessous montre comment ajouter une forme de groupe à une diapositive.

import aspose.slides as slides

# Instancier la classe Presentation.
with slides.Presentation() as presentation:
    # Obtenir la première diapositive.
    slide = presentation.slides[0]

    # Ajouter une forme de groupe à la diapositive.
    group_shape = slide.shapes.add_group_shape()

    # Ajouter des formes à l'intérieur de la forme de groupe.
    group_shape.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 300, 100, 100, 100)
    group_shape.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 500, 100, 100, 100)
    group_shape.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 300, 300, 100, 100)
    group_shape.shapes.add_auto_shape(slides.ShapeType.RECTANGLE, 500, 300, 100, 100)

    # Enregistrer le fichier PPTX sur le disque.
    presentation.save("group_shape.pptx", slides.export.SaveFormat.PPTX)

Accéder à la propriété Alt Text

Cette section explique comment lire le Alt Text des formes contenues dans une forme de groupe sur une diapositive à l’aide d’Aspose.Slides. Pour accéder au Alt Text des formes :

1. Instanciez la classe Presentation pour représenter un fichier PPTX.
2. Obtenez une référence à la diapositive par son index.
3. Accédez à la collection de formes de la diapositive.
4. Accédez au GroupShape.
5. Lisez la propriété Alt Text.

L’exemple ci‑dessous récupère le Alt Text des formes contenues dans les formes de groupe.

import aspose.slides as slides

# Instancier la classe Presentation pour ouvrir le fichier PPTX.
with slides.Presentation("group_shape.pptx") as presentation:
    # Obtenir la première diapositive.
    slide = presentation.slides[0]

    for shape in slide.shapes:
        if isinstance(shape, slides.GroupShape):
            # Accéder à la forme de groupe.
            for child_shape in shape.shapes:
                # Accéder à la propriété Alt Text.
                print(child_shape.alternative_text)

FAQ

Le groupement imbriqué (un groupe à l’intérieur d’un groupe) est‑il pris en charge ?

Oui. GroupShape possède une propriété parent_group qui indique directement la prise en charge de la hiérarchie (un groupe peut être enfant d’un autre groupe).

Comment contrôler l’ordre Z du groupe par rapport aux autres objets de la diapositive ?

Utilisez la propriété z_order_position du GroupShape pour inspecter sa position dans la pile d’affichage.

Puis‑je empêcher le déplacement/la modification/le détourage ?

Oui. La section de verrouillage du groupe est exposée via group_shape_lock, ce qui vous permet de restreindre les opérations sur l’objet.