Forme di gruppo per presentazioni in Java

Panoramica

Questo articolo spiega come lavorare con le forme di gruppo in Aspose.Slides. Mostra come aggiungere una forma di gruppo a una diapositiva, inserire forme all’interno di essa e salvare la presentazione aggiornata. Dimostra inoltre come accedere alle forme memorizzate all’interno di un gruppo e leggere i valori di AlternativeText. Inoltre, l’articolo copre brevemente le funzionalità correlate alle forme di gruppo, come i gruppi nidificati, l’ordine Z e le opzioni di blocco.

Aggiungere una Forma di Gruppo

Aspose.Slides supporta il lavoro con le forme di gruppo nelle diapositive. Questa funzionalità aiuta gli sviluppatori a realizzare presentazioni più ricche. Aspose.Slides for Java supporta l’aggiunta o l’accesso alle forme di gruppo. È possibile aggiungere forme a una forma di gruppo già inserita per popolarla o accedere a qualsiasi proprietà della forma di gruppo. Per aggiungere una forma di gruppo a una diapositiva utilizzando Aspose.Slides for Java:

1. Crea un’istanza della classe Presentation.
2. Ottieni il riferimento di una diapositiva usando il suo indice.
3. Aggiungi una forma di gruppo alla diapositiva.
4. Aggiungi le forme alla forma di gruppo inserita.
5. Salva la presentazione modificata come file PPTX.

L’esempio seguente aggiunge una forma di gruppo a una diapositiva.

// Istanziare la classe Presentation
Presentation pres = new Presentation();
try {
    // Ottenere la prima diapositiva
    ISlide sld = pres.getSlides().get_Item(0);

    // Accesso alla raccolta di forme delle diapositive
    IShapeCollection slideShapes = sld.getShapes();

    // Aggiungere una forma di gruppo alla diapositiva
    IGroupShape groupShape = slideShapes.addGroupShape();
    
    // Aggiungere forme all'interno della forma di gruppo aggiunta
    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);

    // Aggiungere il frame della forma di gruppo
    groupShape.setFrame(new ShapeFrame(100, 300, 500, 40, NullableBool.False, NullableBool.False, 0));

    // Scrivere il file PPTX su disco
    pres.save("GroupShape.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

Accedere alla Proprietà AltText

Questo argomento mostra passaggi semplici, completi di esempi di codice, per aggiungere una forma di gruppo e accedere alla proprietà AltText delle forme di gruppo nelle diapositive. Per accedere a AltText di una forma di gruppo in una diapositiva utilizzando Aspose.Slides for Java:

1. Istanzia la classe Presentation che rappresenta un file PPTX.
2. Ottieni il riferimento di una diapositiva usando il suo indice.
3. Accedi alla raccolta di forme delle diapositive.
4. Accedi alla forma di gruppo.
5. Accedi alla proprietà AlternativeText.

L’esempio seguente accede al testo alternativo della forma di gruppo.

// Istanziare la classe Presentation che rappresenta il file PPTX
Presentation pres = new Presentation("AltText.pptx");
try {
    // Ottenere la prima diapositiva
    ISlide sld = pres.getSlides().get_Item(0);
    
    for (int i = 0; i < sld.getShapes().size(); i++)
    {
        // Accesso alla raccolta di forme delle diapositive
        IShape shape = sld.getShapes().get_Item(i);
    
        if (shape instanceof GroupShape)
        {
            // Accesso alla forma di gruppo.
            IGroupShape grphShape = (IGroupShape)shape;
            for (int j = 0; j < grphShape.getShapes().size(); j++)
            {
                IShape shape2 = grphShape.getShapes().get_Item(j);
                
                // Accesso alla proprietà AltText
                System.out.println(shape2.getAlternativeText());
            }
        }
    }
} finally {
    if (pres != null) pres.dispose();
}

FAQ

È supportato il raggruppamento nidificato (un gruppo all’interno di un altro gruppo)?

Sì. GroupShape dispone del metodo getParentGroup che indica direttamente il supporto alla gerarchia (un gruppo può essere figlio di un altro gruppo).

Come posso controllare l’ordine Z del gruppo rispetto ad altri oggetti sulla diapositiva?

Usa il metodo getZOrderPosition di GroupShape per verificare la sua posizione nello stack di visualizzazione.

Posso impedire lo spostamento/modifica/disaggregazione?

Sì. La sezione di blocco del gruppo è esposta tramite GroupShapeLock che consente di limitare le operazioni sull’oggetto.