Salvar Apresentações em Java

Sobre o que é esta página

Salvar apresentações PowerPoint e OpenDocument em arquivos ou fluxos em Java com Aspose.Slides, e configurar a saída PPTX e o relatório de progresso.

Visão geral

Depois de criar uma apresentação ou abrir uma existente, use o método Presentation.save para gravar o resultado. Aspose.Slides for Java pode salvar uma apresentação em um arquivo ou fluxo nos formatos PowerPoint, OpenDocument, PDF e outros. As seções a seguir cobrem as operações padrão de salvamento e as opções disponíveis para saída PPTX.

Salvar apresentações em arquivos

Para salvar uma apresentação em um arquivo, passe o caminho de saída e um valor SaveFormat para o método Presentation.save. O valor de formato determina o tipo de arquivo que Aspose.Slides cria.

O exemplo a seguir cria uma apresentação e a salva como um arquivo PPTX:

import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation();
try {
    // Adicione ou modifique o conteúdo da apresentação aqui.

    presentation.save("Output.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

Salvar apresentações no formato original

Para exemplos de detecção de arquivos e fluxos, o comportamento de apresentações recém‑criadas e a distinção entre formatos de origem e de saída, consulte Determinar o formato original da apresentação.

Em um aplicativo de processamento em lote, o formato de entrada pode não ser conhecido antecipadamente. Depois de carregar um arquivo, leia seu formato original a partir do método IPresentation.getSourceFormat . Passe o valor SourceFormat resultante para SlideUtil.toSaveFormat para obter o valor SaveFormat correspondente e, então, use Presentation.save para gravar a apresentação modificada.

O exemplo completo a seguir processa cada arquivo em um diretório de entrada, atualiza seu título e o salva em um diretório de saída no formato em que foi carregado:

import com.aspose.slides.Presentation;
import com.aspose.slides.SlideUtil;
import java.io.File;

File inputDirectory = new File("Input");
File outputDirectory = new File("Output");

if (!outputDirectory.exists() && !outputDirectory.mkdirs()) {
    System.err.println("Cannot create the output directory.");
}

File[] inputFiles = inputDirectory.listFiles(File::isFile);
if (inputFiles != null && outputDirectory.isDirectory()) {
    for (File inputFile : inputFiles) {
        try {
            Presentation presentation = new Presentation(inputFile.getPath());
            try {
                int saveFormat = SlideUtil.toSaveFormat(presentation.getSourceFormat());
                presentation.getDocumentProperties().setTitle("Processed by the batch application");

                File outputFile = new File(outputDirectory, inputFile.getName());
                presentation.save(outputFile.getPath(), saveFormat);
            } finally {
                presentation.dispose();
            }
        } catch (IllegalArgumentException exception) {
            System.err.println("Cannot map the source format of '" + inputFile.getPath() + "': " + exception.getMessage());
        } catch (Exception exception) {
            System.err.println("Cannot process '" + inputFile.getPath() + "': " + exception.getMessage());
        }
    }
}

SlideUtil.toSaveFormat mapeia PPT, PPTX, ODP, PPTM, PPSX, PPSM, POTX, POTM, PPS, POT, OTP, FODP e PowerPoint XML para seus respectivos formatos de salvamento de apresentação. Ele mapeia apenas formatos de origem da apresentação; não se destina a selecionar formatos de exportação como PDF, HTML, TIFF ou imagens. Passar um valor SourceFormat não suportado ou inválido resulta em um IllegalArgumentException.

Arquivos legados PPT, PPS e POT usam o mesmo contêiner binário. Quando tal apresentação é carregada de um fluxo sem extensão de arquivo, um arquivo PPS ou POT pode ser identificado como PPT. Se for necessário preservar esses subtipos legados, mantenha o nome de arquivo original ou os metadados de formato separadamente e use-os ao escolher o nome de arquivo e o formato de saída.

Salvar apresentações em fluxos

Para gravar uma apresentação sem depender de um caminho de arquivo final, passe um fluxo gravável e um valor SaveFormat para o método Presentation.save. Essa abordagem é útil quando a saída deve ser retornada de um serviço web, armazenada em um banco de dados ou processada na memória.

O exemplo a seguir salva uma nova apresentação em um fluxo de arquivo:

import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import java.io.FileOutputStream;
import java.io.OutputStream;

Presentation presentation = new Presentation();
try {
    OutputStream outputStream = new FileOutputStream("Output.pptx");
    try {
        presentation.save(outputStream, SaveFormat.Pptx);
    } finally {
        outputStream.close();
    }
} finally {
    presentation.dispose();
}

Salvar apresentações com um tipo de visualização predefinido

Você pode especificar a visualização na qual o PowerPoint abre inicialmente uma apresentação salva. Use o método ViewProperties.setLastView com um valor ViewType antes de salvar.

O exemplo a seguir configura a visualização Slide Master como visualização inicial:

import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import com.aspose.slides.ViewType;

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

Salvar apresentações no formato Office Open XML Strict

Para criar um arquivo PPTX que esteja em conformidade com o perfil Strict do Office Open XML, crie uma instância de PptxOptions e use seu método setConformance com Conformance.Iso29500_2008_Strict. Em seguida, passe as opções para o método Presentation.save.

import com.aspose.slides.Conformance;
import com.aspose.slides.PptxOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

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

Presentation presentation = new Presentation();
try {
    presentation.save("StrictOfficeOpenXml.pptx", SaveFormat.Pptx, options);
} finally {
    presentation.dispose();
}

Salvar apresentações no formato Office Open XML em modo Zip64

Um arquivo ZIP padrão limita o tamanho compactado e descompactado de cada entrada, o tamanho total do arquivo e o número de entradas. Como um arquivo PPTX é um arquivo ZIP, uma apresentação muito grande pode exceder esses limites. Extensões ZIP64 elevam os limites de tamanho e de número de entradas aplicáveis.

Use o método PptxOptions.setZip64Mode para controlar se o Aspose.Slides grava extensões ZIP64:

[IfNecessary] usa ZIP64 somente quando a apresentação excede os limites padrão do ZIP. Este é o modo padrão.
[Never] desativa extensões ZIP64.
[Always] sempre grava extensões ZIP64.

O exemplo a seguir sempre habilita extensões ZIP64 para a apresentação de saída:

import com.aspose.slides.PptxOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;
import com.aspose.slides.Zip64Mode;

Presentation presentation = new Presentation("Sample.pptx");
try {
    PptxOptions options = new PptxOptions();
    options.setZip64Mode(Zip64Mode.Always);

    presentation.save("OutputZip64.pptx", SaveFormat.Pptx, options);
} finally {
    presentation.dispose();
}

Warning

Se Zip64Mode.Never for usado e a apresentação não couber nos limites padrão do ZIP, a operação de salvamento lançará um PptxException.

Salvar apresentações no formato Office Open XML com níveis de compressão

Para a saída PPTX, você pode equilibrar a velocidade de salvamento e o tamanho do arquivo usando o método PptxOptions.setCompressionLevel. A classe CompressionLevel fornece esses valores:

[None] armazena dados sem compressão.
[Level1] fornece a compressão mais rápida e o maior arquivo compactado.
[Level2] até [Level5] favorecem progressivamente uma saída menor em detrimento da velocidade de salvamento.
[Level6] equilibra velocidade de salvamento e tamanho do arquivo. Este é o nível padrão.
[Level7] e [Level8] favorecem ainda mais uma saída menor em detrimento da velocidade de salvamento.
[Level9] fornece a compressão mais forte e requer mais tempo de processamento.

O exemplo a seguir salva uma apresentação sem compressão:

import com.aspose.slides.CompressionLevel;
import com.aspose.slides.PptxOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("Sample.pptx");
try {
    PptxOptions options = new PptxOptions();
    options.setCompressionLevel(CompressionLevel.None);

    presentation.save("OutputNoCompression.pptx", SaveFormat.Pptx, options);
} finally {
    presentation.dispose();
}

O exemplo a seguir usa o nível máximo de compressão:

import com.aspose.slides.CompressionLevel;
import com.aspose.slides.PptxOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("Sample.pptx");
try {
    PptxOptions options = new PptxOptions();
    options.setCompressionLevel(CompressionLevel.Level9);

    presentation.save("OutputMaximumCompression.pptx", SaveFormat.Pptx, options);
} finally {
    presentation.dispose();
}

Salvar apresentações sem atualizar a miniatura

Quando uma apresentação é salva como PPTX, o método PptxOptions.setRefreshThumbnail controla sua miniatura de documento:

true regenera a miniatura durante a operação de salvamento. Este é o valor padrão.
false preserva a miniatura existente. Se a apresentação não tiver miniatura, o Aspose.Slides não gera uma.

O exemplo a seguir salva uma apresentação sem atualizar sua miniatura:

import com.aspose.slides.PptxOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

Presentation presentation = new Presentation("Sample.pptx");
try {
    PptxOptions options = new PptxOptions();
    options.setRefreshThumbnail(false);

    presentation.save("Output.pptx", SaveFormat.Pptx, options);
} finally {
    presentation.dispose();
}

Note

Desativar a atualização da miniatura pode reduzir o tempo necessário para salvar um arquivo PPTX.

Atualizações de progresso de salvamento em porcentagem

Para monitorar uma operação de salvamento, implemente a interface IProgressCallback e passe a implementação para o método ISaveOptions.setProgressCallback. O Aspose.Slides então chama o método IProgressCallback.reporting com valores de progresso durante a exportação.

O exemplo a seguir relata o progresso de uma exportação PDF no console:

import com.aspose.slides.IProgressCallback;
import com.aspose.slides.PdfOptions;
import com.aspose.slides.Presentation;
import com.aspose.slides.SaveFormat;

class ExportProgressHandler implements IProgressCallback {
    public void reporting(double progressValue) {
        int progress = (int) progressValue;
        System.out.println(progress + "% of the file has been converted.");
    }
}

PdfOptions options = new PdfOptions();
options.setProgressCallback(new ExportProgressHandler());

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

Note

A Aspose fornece um Splitter de PowerPoint gratuito, construído com a API Aspose.Slides. Ele salva slides selecionados de uma apresentação como arquivos PPT ou PPTX separados.

FAQ

O Aspose.Slides oferece suporte a salvamento incremental ou “salvamento rápido”?

Não. Cada operação de salvamento grava um arquivo de saída completo em vez de atualizar apenas as partes alteradas.

Várias threads podem salvar a mesma instância de Presentation?

Não. Uma instância de Presentation não é thread‑safe. Acesse e salve cada instância apenas de um thread por vez.

O que acontece com hyperlinks e arquivos vinculados externamente quando salvo uma apresentação?

Os hyperlinks permanecem na apresentação. Aspose.Slides não copia arquivos vinculados externamente, portanto a apresentação salva ainda deve ser capaz de acessar seus locais.

Posso salvar metadados do documento, como autor, título, empresa e data de criação?

Sim. Defina as propriedades de documento apropriadas antes de salvar, e Aspose.Slides as grava no arquivo de saída.

Converter Apresentações para Múltiplos Formatos em Java Gerenciar Slide Show em Java