Formes de groupe de présentation en Java

Ajouter une forme groupée

Aspose.Slides prend en charge le travail avec des formes groupées sur les diapositives. Cette fonctionnalité aide les développeurs à créer des présentations plus riches. Aspose.Slides for Java prend en charge l’ajout ou l’accès aux formes groupées. Il est possible d’ajouter des formes à une forme groupée ajoutée pour la remplir ou accéder à n’importe quelle propriété de la forme groupée. Pour ajouter une forme groupée à une diapositive à l’aide d’Aspose.Slides for Java :

1. Créez une instance de la classe Presentation.
2. Obtenez la référence d’une diapositive en utilisant son Index
3. Ajoutez une forme groupée à la diapositive.
4. Ajoutez les formes à la forme groupée ajoutée.
5. Enregistrez la présentation modifiée au format PPTX.

L’exemple ci-dessous ajoute une forme groupée à une diapositive.

// Instancier la classe Presentation
Presentation pres = new Presentation();
try {
    // Obtenir la première diapositive
    ISlide sld = pres.getSlides().get_Item(0);

    // Accéder à la collection de formes des diapositives
    IShapeCollection slideShapes = sld.getShapes();

    // Ajouter une forme groupée à la diapositive
    IGroupShape groupShape = slideShapes.addGroupShape();
    
    // Ajouter des formes à l'intérieur de la forme groupée ajoutée
    groupShape.getShapes().addAutoShape(ShapeType.Rectangle, 300, 100, 100, 100);
    groupShape.getShapes().addAutoShape(ShapeType.Rectangle, 500, 100, 100, 100);
    groupShape.getShapes().addAutoShape(ShapeType.Rectangle, 300, 300, 100, 100);
    groupShape.getShapes().addAutoShape(ShapeType.Rectangle, 500, 300, 100, 100);

    // Ajouter le cadre de la forme groupée
    groupShape.setFrame(new ShapeFrame(100, 300, 500, 40, NullableBool.False, NullableBool.False, 0));

    // Écrire le fichier PPTX sur le disque
    pres.save("GroupShape.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Accéder à la propriété AltText

Ce sujet présente des étapes simples, illustrées par des exemples de code, pour ajouter une forme groupée et accéder à la propriété AltText des formes groupées sur les diapositives. Pour accéder à l’AltText d’une forme groupée dans une diapositive à l’aide d’Aspose.Slides for Java :

1. Instanciez la classe Presentation qui représente le fichier PPTX.
2. Obtenez la référence d’une diapositive en utilisant son Index.
3. Accédez à la collection de formes des diapositives.
4. Accédez à la forme groupée.
5. Accédez à la propriété AlternativeText.

L’exemple ci-dessous accède au texte alternatif de la forme groupée.

// Instancier la classe Presentation qui représente le fichier PPTX
Presentation pres = new Presentation("AltText.pptx");
try {
    // Obtenir la première diapositive
    ISlide sld = pres.getSlides().get_Item(0);
    
    for (int i = 0; i < sld.getShapes().size(); i++)
    {
        // Accéder à la collection de formes des diapositives
        IShape shape = sld.getShapes().get_Item(i);
    
        if (shape instanceof GroupShape)
        {
            // Accéder à la forme groupée.
            IGroupShape grphShape = (IGroupShape)shape;
            for (int j = 0; j < grphShape.getShapes().size(); j++)
            {
                IShape shape2 = grphShape.getShapes().get_Item(j);
                
                // Accéder à la propriété AltText
                System.out.println(shape2.getAlternativeText());
            }
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

FAQ

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

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

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

Utilisez la méthode getZOrderPosition du GroupShape pour inspecter sa position dans la pile d’affichage.

Puis‑je empêcher le déplacement/édition/dégrouper ?

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