Salvare presentazioni in Java

Di cosa tratta questa pagina

Scopri come salvare presentazioni in Java usando Aspose.Slides—esporta in PowerPoint o OpenDocument mantenendo layout, caratteri ed effetti.

Panoramica

Open Presentations in Java descrive come utilizzare la classe Presentation per aprire una presentazione. Questo articolo spiega come creare e salvare presentazioni. La classe Presentation contiene il contenuto di una presentazione. Che tu stia creando una presentazione da zero o modificando una esistente, dovrai salvarla al termine. Con Aspose.Slides per Java, puoi salvare su un file o su stream. Questo articolo descrive i diversi modi per salvare una presentazione.

Salva le presentazioni su file

Salva una presentazione su un file chiamando il metodo save della classe Presentation. Passa il nome file e il formato di salvataggio al metodo. L’esempio seguente mostra come salvare una presentazione con Aspose.Slides.

import com.aspose.slides.*;

// Istanziare la classe Presentation che rappresenta un file di presentazione.
Presentation presentation = new Presentation();
try {
    // Eseguire qualche operazione...

    // Salvare la presentazione su un file.
    presentation.save("Output.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Salva le presentazioni su stream

Puoi salvare una presentazione su uno stream passando uno stream di output al metodo save della classe Presentation. Una presentazione può essere scritta su molti tipi di stream. Nell’esempio qui sotto, creiamo una nuova presentazione e la salviamo su uno stream di file.

import com.aspose.slides.*;
import java.io.FileOutputStream;
import java.io.OutputStream;

// Istanziare la classe Presentation che rappresenta un file di presentazione.
Presentation presentation = new Presentation();
try {
    OutputStream fileStream = new FileOutputStream("Output.pptx");
    try {
        // Salvare la presentazione nello stream.
        presentation.save(fileStream, SaveFormat.Pptx);
    } finally {
        fileStream.close();
    }
} finally {
    presentation.dispose();
}

Salva le presentazioni con un tipo di visualizzazione predefinito

Aspose.Slides consente di impostare la visualizzazione iniziale che PowerPoint utilizza quando la presentazione generata viene aperta tramite la classe ViewProperties. Usa il metodo setLastView con un valore dell’enumerazione ViewType.

import com.aspose.slides.*;

Presentation presentation = new Presentation();
try {
    presentation.getViewProperties().setLastView(ViewType.SlideMasterView);
    presentation.save("SlideMasterView.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Salva le presentazioni nel formato Strict Office Open XML

Aspose.Slides consente di salvare una presentazione nel formato Strict Office Open XML. Usa la classe PptxOptions e imposta la sua proprietà conformance durante il salvataggio. Se imposti Conformance.Iso29500_2008_Strict, il file di output viene salvato nel formato Strict Office Open XML.

L’esempio qui sotto crea una presentazione e la salva nel formato Strict Office Open XML.

import com.aspose.slides.*;

PptxOptions options = new PptxOptions();
options.setConformance(Conformance.Iso29500_2008_Strict);

// Istanziare la classe Presentation che rappresenta un file di presentazione.
Presentation presentation = new Presentation();
try {
    // Salvare la presentazione nel formato Strict Office Open XML.
    presentation.save("StrictOfficeOpenXml.pptx", SaveFormat.Pptx, options);
} finally {
    presentation.dispose();
}

Salva le presentazioni nel formato Office Open XML in modalità Zip64

Un file Office Open XML è un archivio ZIP che impone limiti di 4 GB (2^32 byte) sulla dimensione non compressa di qualsiasi file, sulla dimensione compressa di qualsiasi file e sulla dimensione totale dell’archivio, e limita anche l’archivio a 65 535 (2^16‑1) file. Le estensioni del formato ZIP64 aumentano questi limiti a 2^64.

Il metodo IPptxOptions.setZip64Mode consente di scegliere quando utilizzare le estensioni del formato ZIP64 durante il salvataggio di un file Office Open XML.

Questo metodo può essere usato con le seguenti modalità:

IfNecessary utilizza le estensioni ZIP64 solo se la presentazione supera le limitazioni sopra. È la modalità predefinita.
Never non utilizza mai le estensioni ZIP64.
Always utilizza sempre le estensioni ZIP64.

Il codice seguente dimostra come salvare una presentazione come file PPTX con le estensioni ZIP64 abilitate:

import com.aspose.slides.*;

PptxOptions pptxOptions = new PptxOptions();
pptxOptions.setZip64Mode(Zip64Mode.Always);

Presentation presentation = new Presentation("Sample.pptx");
try {
    presentation.save("OutputZip64.pptx", SaveFormat.Pptx, pptxOptions);
} finally {
    presentation.dispose();
}

NOTE

Quando salvi con Zip64Mode.Never, viene generata un’PptxException se la presentazione non può essere salvata nel formato ZIP32.

Salva le presentazioni nel formato Office Open XML con livelli di compressione

Quando lavori con presentazioni di grandi dimensioni, puoi regolare il livello di compressione per bilanciare la dimensione del file e il tempo di elaborazione. A seconda delle tue esigenze, potresti preferire una compressione più veloce o file di output più piccoli.

Aspose.Slides fornisce il metodo IPptxOptions.setCompressionLevel, che consente di specificare il livello di compressione da utilizzare quando si salva una presentazione nel formato Office Open XML.

Sono disponibili i seguenti livelli di compressione:

None: nessuna compressione. I file vengono archiviati così come sono.
Level1: compressione più veloce con il rapporto di compressione più basso.
Level2: compressione più veloce con un rapporto di compressione leggermente migliore rispetto a Level1.
Level3: fornisce una compressione migliore rispetto a Level2 con un impatto moderato sul tempo di elaborazione.
Level4: fornisce una compressione migliore rispetto a Level3.
Level5: fornisce una compressione migliorata rispetto a Level4 con ulteriore tempo di elaborazione.
Level6: compressione standard che offre un buon equilibrio tra velocità di elaborazione e dimensione del file. È il livello di compressione predefinito.
Level7: fornisce una compressione migliore rispetto a Level6 con elaborazione più lenta.
Level8: fornisce una compressione migliore rispetto a Level7.
Level9: compressione massima. Produce il file più piccolo al costo del tempo di elaborazione più lungo.

L’esempio seguente dimostra come salvare una presentazione come file PPTX senza compressione:

import com.aspose.slides.*;

PptxOptions pptxOptions = new PptxOptions();
pptxOptions.setCompressionLevel(CompressionLevel.None);

Presentation presentation = new Presentation("Sample.pptx");
try {
    presentation.save("Sample-out.pptx", SaveFormat.Pptx, pptxOptions);
} finally {
    presentation.dispose();
}

Questo esempio mostra come salvare una presentazione come file PPTX con compressione massima:

import com.aspose.slides.*;

PptxOptions pptxOptions = new PptxOptions();
pptxOptions.setCompressionLevel(CompressionLevel.Level9);

Presentation presentation = new Presentation("Sample.pptx");
try {
    presentation.save("Sample-level9.pptx", SaveFormat.Pptx, pptxOptions);
} finally {
    presentation.dispose();
}

Salva le presentazioni senza aggiornare la miniatura

Il metodo PptxOptions.setRefreshThumbnail controlla la generazione della miniatura quando si salva una presentazione in PPTX:

Se impostato a true, la miniatura viene aggiornata durante il salvataggio. È il valore predefinito.
Se impostato a false, la miniatura corrente viene conservata. Se la presentazione non ha una miniatura, non viene generata alcuna miniatura.

Nel codice qui sotto, la presentazione viene salvata in PPTX senza aggiornare la sua miniatura.

import com.aspose.slides.*;

PptxOptions pptxOptions = new PptxOptions();
pptxOptions.setRefreshThumbnail(false);

Presentation presentation = new Presentation("Sample.pptx");
try {
    presentation.save("Output.pptx", SaveFormat.Pptx, pptxOptions);
}
finally {
    presentation.dispose();
}

Info

Questa opzione aiuta a ridurre il tempo necessario per salvare una presentazione in formato PPTX.

Salva gli aggiornamenti di avanzamento in percentuale

L’interfaccia IProgressCallback viene utilizzata tramite il metodo setProgressCallback esposto dall’interfaccia ISaveOptions e dalla classe astratta SaveOptions. Assegna un’implementazione di IProgressCallback con setProgressCallback per ricevere aggiornamenti sullo stato di salvataggio in percentuale.

Il frammento di codice seguente mostra come usare IProgressCallback.

import com.aspose.slides.*;

class ExportProgressHandler implements IProgressCallback {
    public void reporting(double progressValue) {
        // Utilizzare qui il valore della percentuale di avanzamento.
        int progress = (int) progressValue;

        System.out.println(progress + "% of the file has been converted.");
    }
}

ISaveOptions saveOptions = new PdfOptions();
saveOptions.setProgressCallback(new ExportProgressHandler());

Presentation presentation = new Presentation("Sample.pptx");
try {
    presentation.save("Output.pdf", SaveFormat.Pdf, saveOptions);
} finally {
    presentation.dispose();
}

Info

Aspose ha sviluppato una app gratuita PowerPoint Splitter utilizzando la propria API. L’app consente di dividere una presentazione in più file salvando le diapositive selezionate come nuovi file PPTX o PPT.

FAQ

Il “salvataggio veloce” (salvataggio incrementale) è supportato in modo che vengano scritte solo le modifiche?

No. Il salvataggio crea il file di destinazione completo ogni volta; il “salvataggio veloce” incrementale non è supportato.

È thread‑safe salvare la stessa istanza di Presentation da più thread?

No. Una Presentation non è thread‑safe (/slides/it/java/multithreading/); salvala da un singolo thread.

Cosa succede ai collegamenti ipertestuali e ai file collegati esternamente durante il salvataggio?

Hyperlinks vengono preservati. I file collegati esternamente (ad es. video tramite percorsi relativi) non vengono copiati automaticamente: assicurati che i percorsi di riferimento rimangano accessibili.

Posso impostare/salvare i metadati del documento (Autore, Titolo, Azienda, Data)?

Sì. Le proprietà del documento standard sono supportate e verranno scritte nel file al salvataggio.

Converti presentazioni in più formati con Java Gestisci la presentazione in Java