Forme di Gruppo nelle Presentazioni in JavaScript

Panoramica

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

Aggiungi Forma di Gruppo

Aspose.Slides supporta la gestione delle forme di gruppo nelle diapositive. Questa funzionalità aiuta gli sviluppatori a creare presentazioni più ricche. Aspose.Slides per Node.js via Java consente di aggiungere o accedere alle forme di gruppo. È possibile aggiungere forme a una forma di gruppo appena creata per popolarla o accedere a qualsiasi proprietà della forma di gruppo. Per aggiungere una forma di gruppo a una diapositiva usando Aspose.Slides per Node.js via 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 appena aggiunta.
5. Salva la presentazione modificata come file PPTX.

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

// Istanziare la classe Presentation
var pres = new aspose.slides.Presentation();
try {
    // Ottieni la prima diapositiva
    var sld = pres.getSlides().get_Item(0);
    // Accesso alla collezione di forme delle diapositive
    var slideShapes = sld.getShapes();
    // Aggiunta di una forma di gruppo alla diapositiva
    var groupShape = slideShapes.addGroupShape();
    // Aggiunta di forme all'interno della forma di gruppo aggiunta
    groupShape.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 300, 100, 100, 100);
    groupShape.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 500, 100, 100, 100);
    groupShape.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 300, 300, 100, 100);
    groupShape.getShapes().addAutoShape(aspose.slides.ShapeType.Rectangle, 500, 300, 100, 100);
    // Aggiunta del frame della forma di gruppo
    groupShape.setFrame(new aspose.slides.ShapeFrame(100, 300, 500, 40, aspose.slides.NullableBool.False, aspose.slides.NullableBool.False, 0));
    // Scrivi il file PPTX su disco
    pres.save("GroupShape.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Accedi 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 usando Aspose.Slides per Node.js via Java:

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

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

// Istanziare la classe Presentation che rappresenta il file PPTX
var pres = new aspose.slides.Presentation("AltText.pptx");
try {
    // Ottieni la prima diapositiva
    var sld = pres.getSlides().get_Item(0);
    for (var i = 0; i < sld.getShapes().size(); i++) {
        // Accesso alla collezione di forme delle diapositive
        var shape = sld.getShapes().get_Item(i);
        if (java.instanceOf(shape, "com.aspose.slides.GroupShape")) {
            // Accesso alla forma di gruppo.
            var grphShape = shape;
            for (var j = 0; j < grphShape.getShapes().size(); j++) {
                var shape2 = grphShape.getShapes().get_Item(j);
                // Accesso alla proprietà AltText
                console.log(shape2.getAlternativeText());
            }
        }
    }
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

FAQ

Il raggruppamento nidificato (un gruppo all’interno di un altro gruppo) è supportato?

Sì. GroupShape ha un 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 nella diapositiva?

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

Posso impedire lo spostamento/modifica/scioglimento del gruppo?

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