# Forme di gruppo per presentazioni in Java

> Impara a raggruppare e separare le forme nei deck PowerPoint utilizzando Aspose.Slides per Java—guida rapida, passo passo, con codice Java gratuito.

Source: https://docs.aspose.com/slides/it/java/group/
Updated: 2026-06-12

## **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](https://reference.aspose.com/slides/it/java/com.aspose.slides/Presentation).
1. Ottieni il riferimento di una diapositiva usando il suo indice.
1. Aggiungi una forma di gruppo alla diapositiva.
1. Aggiungi le forme alla forma di gruppo inserita.
1. Salva la presentazione modificata come file PPTX.

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

```java
// 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](https://reference.aspose.com/slides/it/java/com.aspose.slides/Presentation) che rappresenta un file PPTX.
1. Ottieni il riferimento di una diapositiva usando il suo indice.
1. Accedi alla raccolta di forme delle diapositive.
1. Accedi alla forma di gruppo.
1. Accedi alla proprietà [AlternativeText](https://reference.aspose.com/slides/it/java/com.aspose.slides/IShape#getAlternativeText--).

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

```java
// 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](https://reference.aspose.com/slides/it/java/com.aspose.slides/groupshape/) dispone del metodo [getParentGroup](https://reference.aspose.com/slides/it/java/com.aspose.slides/shape/#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](https://reference.aspose.com/slides/it/java/com.aspose.slides/shape/#getZOrderPosition--) di [GroupShape](https://reference.aspose.com/slides/it/java/com.aspose.slides/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](https://reference.aspose.com/slides/it/java/com.aspose.slides/groupshape/#getGroupShapeLock--) che consente di limitare le operazioni sull'oggetto.