Applica o cambia i layout delle diapositive su Android

Di cosa tratta questa pagina

Applica, crea e modifica i layout delle diapositive in Aspose.Slides per Android via Java, aggiungi segnaposti, rimuovi layout inutilizzati e controlla la visibilità del piè di pagina.

Panoramica

Un layout di diapositiva definisce le posizioni e la formattazione dei segnaposti come titoli, testo, immagini, grafici e tabelle. Applicare un layout conferisce alle diapositive una struttura coerente mentre consente a ciascuna diapositiva di contenere il proprio contenuto.

I layout più comuni includono:

Titolo diapositiva: Contiene segnaposti per titolo e sottotitolo.
Titolo e contenuto: Contiene un segnaposto per il titolo e un segnaposto di contenuto a uso generico.
Vuota: Non contiene segnaposti di contenuto ed è utile quando ogni forma sarà posizionata manualmente.

Comprendere l’eredità dei layout

Una presentazione ha tre livelli correlati:

Un master slide definisce il tema, la formattazione condivisa, gli sfondi e gli oggetti comuni.
Un layout slide appartiene a un master e definisce una particolare disposizione dei segnaposti.
Una normal slide utilizza un layout e memorizza il contenuto inserito per quella diapositiva.

Una diapositiva normale eredita tema e formattazione dal suo layout, e il layout eredita dal suo master. Un valore impostato direttamente su una diapositiva normale sovrascrive il valore ereditato a quel livello. Quando una diapositiva normale viene creata, le forme dei segnaposti vengono generate dal layout selezionato, mentre il contenuto inserito in quei segnaposti appartiene alla diapositiva normale.

Aggiungi segnaposti richiesti a un layout prima di creare diapositive da esso. Aggiungere in seguito un altro segnaposto a un layout non aggiunge automaticamente la forma segnaposto corrispondente alle diapositive normali esistenti.

Questa relazione ha due importanti conseguenze:

Modificare la formattazione ereditata o la geometria dei segnaposti esistenti su un layout può aggiornare tutte le diapositive che dipendono da esso. Prima di modificare un layout già in uso, esamina le diapositive dipendenti e rivedi la presentazione risultante.
Un layout ancora utilizzato da una diapositiva non può essere rimosso. Riassegna prima le sue diapositive dipendenti a un altro layout, oppure rimuovi solo i layout non usati.

Per ulteriori informazioni sul livello superiore di questa gerarchia, vedere Slide Master.

Per nascondere loghi ereditati o forme decorative del master su una diapositiva o tramite un layout condiviso, vedere Control the Visibility of Master Graphics. L’esempio confronta due diapositive che utilizzano lo stesso master.

Selezionare e applicare un layout di diapositiva

Utilizza un tipo di layout quando la presentazione segue le definizioni di layout standard di PowerPoint. I nomi dei layout sono modificabili dall’utente e possono essere localizzati, quindi la selezione basata sul nome è meno affidabile a meno che non si controlli il modello di origine.

L’esempio seguente cerca Title and Content nel primo master. Se quel layout non è disponibile, ricade deliberatamente su Blank. Il secondo controllo null è necessario perché una presentazione può contenere solo layout personalizzati. Il layout selezionato viene quindi applicato alla prima diapositiva normale tramite il metodo ISlide.setLayoutSlide.

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    IMasterLayoutSlideCollection layoutSlides = presentation.getMasters().get_Item(0).getLayoutSlides();
    ILayoutSlide targetLayout = layoutSlides.getByType(SlideLayoutType.TitleAndObject);

    if (targetLayout == null) {
        targetLayout = layoutSlides.getByType(SlideLayoutType.Blank);
    }

    if (targetLayout == null) {
        throw new IllegalStateException("The first master does not contain a suitable layout slide.");
    }

    presentation.getSlides().get_Item(0).setLayoutSlide(targetLayout);
    presentation.save("output-with-new-layout.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Modificare il layout di una diapositiva non rimuove le forme ordinarie aggiunte direttamente alla diapositiva. Tuttavia, le posizioni dei segnaposti, la formattazione ereditata e la corrispondenza tra i segnaposti esistenti e il nuovo layout possono cambiare, quindi ispeziona l’output quando passi tra layout sostanzialmente diversi.

Aggiungere una diapositiva layout

Selezione e creazione sono operazioni separate. L’esempio precedente seleziona un layout esistente; non ne crea uno. Per creare un layout, chiama il metodo IMasterLayoutSlideCollection.add sulla collezione di layout del master di destinazione.

L’esempio seguente aggiunge sempre un nuovo layout Title and Content denominato Report Title and Content, quindi aggiunge una diapositiva normale basata su di esso. I nomi dei layout devono essere unici all’interno della collezione.

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    IMasterSlide masterSlide = presentation.getMasters().get_Item(0);
    ILayoutSlide reportLayout = masterSlide.getLayoutSlides().add(SlideLayoutType.TitleAndObject, "Report Title and Content");
    presentation.getSlides().addEmptySlide(reportLayout);

    presentation.save("output-with-report-layout.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Aggiungi un layout solo quando il modello ha realmente bisogno di un’altra struttura riutilizzabile. Se esiste già un layout adeguato, selezionalo e riutilizzalo invece di crearne un duplicato.

Aggiungere segnaposti a una diapositiva layout

Il metodo ILayoutSlide.getPlaceholderManager fornisce un ILayoutPlaceholderManager per aggiungere forme segnaposto a un layout.

Segnaposto PowerPoint	`ILayoutPlaceholderManager` Metodo
	`addContentPlaceholder(float x, float y, float width, float height)`
	`addVerticalContentPlaceholder(float x, float y, float width, float height)`
	`addTextPlaceholder(float x, float y, float width, float height)`
	`addVerticalTextPlaceholder(float x, float y, float width, float height)`
	`addPicturePlaceholder(float x, float y, float width, float height)`
	`addChartPlaceholder(float x, float y, float width, float height)`
	`addTablePlaceholder(float x, float y, float width, float height)`
	`addSmartArtPlaceholder(float x, float y, float width, float height)`
	`addMediaPlaceholder(float x, float y, float width, float height)`
	`addOnlineImagePlaceholder(float x, float y, float width, float height)`

L’esempio seguente verifica che il layout Blank esista, aggiunge quattro segnaposti a esso e quindi crea una diapositiva normale che utilizza il layout modificato. L’ordine è intenzionale: i segnaposti sono aggiunti prima che la diapositiva normale sia creata, così Aspose.Slides può generare le forme segnaposto corrispondenti su quella diapositiva.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    ILayoutSlide blankLayout = presentation.getLayoutSlides().getByType(SlideLayoutType.Blank);

    if (blankLayout == null) {
        throw new IllegalStateException("The presentation does not contain a Blank layout slide.");
    }

    ILayoutPlaceholderManager placeholderManager = blankLayout.getPlaceholderManager();
    placeholderManager.addContentPlaceholder(20, 20, 310, 270);
    placeholderManager.addVerticalTextPlaceholder(350, 20, 350, 270);
    placeholderManager.addChartPlaceholder(20, 310, 310, 180);
    placeholderManager.addTablePlaceholder(350, 310, 350, 180);

    presentation.getSlides().addEmptySlide(blankLayout);
    presentation.save("output-with-placeholders.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Il risultato:

I segnaposti sulla diapositiva layout

Warning

Modificare la formattazione ereditata o la geometria dei segnaposti esistenti su un layout può influire sulle diapositive dipendenti. Un segnaposto layout aggiunto di recente non viene retroattivamente inserito nelle diapositive normali esistenti. Prova le modifiche al layout su una copia della presentazione e ispeziona ogni diapositiva dipendente.

Rimuovere le diapositive layout inutilizzate

Usa il metodo Compress.removeUnusedLayoutSlides per rimuovere i layout a cui nessuna diapositiva normale fa riferimento. Il metodo lascia intatti i layout ancora in uso.

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    Compress.removeUnusedLayoutSlides(presentation);
    presentation.save("output-without-unused-layouts.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Per rimuovere un layout specifico, utilizza prima il suo metodo hasDependingSlides o getDependingSlides. Riassegna le eventuali diapositive dipendenti prima di chiamare ILayoutSlide.remove. Tentare di rimuovere un layout in uso genera una PptxEditException.

Controllare la visibilità del piè di pagina su una diapositiva layout

Un layout ha i propri segnaposti per piè di pagina, numero diapositiva e data/ora. Usa il metodo ILayoutSlide.getHeaderFooterManager per controllare quei segnaposti su un singolo layout. È utile quando, ad esempio, i layout di contenuto devono mostrare i piè di pagina ma i layout di titolo no.

L’esempio seguente seleziona un layout in modo sicuro e rende visibili gli elementi del piè di pagina:

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    ILayoutSlide layoutSlide = presentation.getLayoutSlides().getByType(SlideLayoutType.TitleAndObject);

    if (layoutSlide == null) {
        layoutSlide = presentation.getLayoutSlides().getByType(SlideLayoutType.Blank);
    }

    if (layoutSlide == null) {
        throw new IllegalStateException("The presentation does not contain a suitable layout slide.");
    }

    ILayoutSlideHeaderFooterManager headerFooterManager = layoutSlide.getHeaderFooterManager();
    headerFooterManager.setFooterVisibility(true);
    headerFooterManager.setSlideNumberVisibility(true);
    headerFooterManager.setDateTimeVisibility(true);
    headerFooterManager.setFooterText("Footer text");
    headerFooterManager.setDateTimeText("Date and time text");

    presentation.save("output-with-layout-footers.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Controllare la visibilità del piè di pagina su un master e sui suoi layout figli

Per applicare impostazioni di piè di pagina coerenti su un’intera gerarchia di master, usa il metodo IMasterSlide.getHeaderFooterManager. I metodi di propagazione di IMasterSlideHeaderFooterManager operano sul master e sui suoi layout e diapositive normali dipendenti; non si applicano a una singola diapositiva normale.

import com.aspose.slides.*;

Presentation presentation = new Presentation("input.pptx");
try {
    IMasterSlideHeaderFooterManager headerFooterManager = presentation.getMasters().get_Item(0).getHeaderFooterManager();
    headerFooterManager.setFooterAndChildFootersVisibility(true);
    headerFooterManager.setSlideNumberAndChildSlideNumbersVisibility(true);
    headerFooterManager.setDateTimeAndChildDateTimesVisibility(true);
    headerFooterManager.setFooterAndChildFootersText("Footer text");
    headerFooterManager.setDateTimeAndChildDateTimesText("Date and time text");

    presentation.save("output-with-master-footers.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

FAQ

Qual è la differenza tra un master slide e un layout slide?

Un master slide definisce il tema della presentazione e la formattazione condivisa. Un layout slide appartiene a un master e definisce una disposizione riutilizzabile di segnaposti. Le diapositive normali usano quei layout e memorizzano il contenuto specifico della diapositiva.

Posso copiare un layout slide da una presentazione a un’altra?

Sì. Aggiungi una copia alla collezione di destinazione con il metodo addClone. Quando copi tra presentazioni, verifica anche i font, i temi, le immagini e le altre risorse utilizzate dal layout di origine.

Cosa succede quando modifico un layout già in uso?

Le diapositive dipendenti ereditano le modifiche al layout, a meno che non sovrascrivano localmente la formattazione o gli oggetti interessati. La geometria dei segnaposti e lo stile ereditato possono quindi cambiare su molte diapositive contemporaneamente. Usa getDependingSlides per identificare le diapositive interessate prima di modificare il layout.

Cosa succede se rimuovo un layout ancora in uso?

Aspose.Slides solleva una PptxEditException. Riassegna prima le diapositive dipendenti, oppure usa removeUnusedLayoutSlides per rimuovere solo i layout non referenziati.

Confronta diapositive di presentazioni su Android Gestisci i master slide della presentazione su Android