Como Carregar Apresentações em Java

Aspose.Slides FOSS for Java lets you open any .pptx arquivo, inspecione seu conteúdo e ou salve‑o novamente como PPTX ou extraia dados dele. Este guia cobre a abertura de um arquivo, a iteração de slides, a leitura de texto de formas e o round‑trip do salvamento.

Guia passo a passo

Etapa 1: Adicionar a dependência Maven

<dependency>
  <groupId>org.aspose.slides.foss</groupId>
  <artifactId>aspose-slides-foss</artifactId>
  <version>1.0.0</version>
</dependency>

Etapa 2: Abrir uma Apresentação Existente

Passe o caminho do arquivo para o Presentation construtor. Use try-with-resources para garantir a limpeza.

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IShape;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IDocumentProperties;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation("input.pptx")) {
    System.out.println("Slide count: " + prs.getSlides().size());
    prs.save("output.pptx", SaveFormat.PPTX);
}

Partes XML desconhecidas no arquivo fonte são preservadas literalmente: a biblioteca nunca remove conteúdo que ainda não entende.

Etapa 3: Inspecionar Slides

Itere sobre todos os slides e imprima a contagem de formas:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IShape;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IDocumentProperties;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation("deck.pptx")) {
    for (int i = 0; i < prs.getSlides().size(); i++) {
        ISlide slide = prs.getSlides().get(i);
        int shapeCount = slide.getShapes().size();
        System.out.println("Slide " + i + ": " + shapeCount + " shapes");
    }
}

Etapa 4: Ler Texto das Formas

Itere sobre as formas e leia o texto das formas que possuem um TextFrame:

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IShape;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IDocumentProperties;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation("deck.pptx")) {
    for (ISlide slide : prs.getSlides()) {
        for (IShape shape : slide.getShapes()) {
            if (shape instanceof IAutoShape) {
                IAutoShape autoShape = (IAutoShape) shape;
                ITextFrame tf = autoShape.getTextFrame();
                if (tf != null && !tf.getText().isEmpty()) {
                    System.out.println("  Shape text: " + tf.getText());
                }
            }
        }
    }
}

Etapa 5: Ler Propriedades do Documento

Acesse as propriedades principais do documento a partir de prs.getDocumentProperties():

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IShape;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IDocumentProperties;
import org.aspose.slides.foss.export.SaveFormat;

try (Presentation prs = new Presentation("deck.pptx")) {
    IDocumentProperties props = prs.getDocumentProperties();
    System.out.println("Title:   " + props.getTitle());
    System.out.println("Author:  " + props.getAuthor());
    System.out.println("Subject: " + props.getSubject());
}

Etapa 6: Salvamento de Ida e Volta

Depois de inspecionar ou modificar a apresentação, salve-a de volta em PPTX:

prs.save("output.pptx", SaveFormat.PPTX);

Salvar em um caminho diferente cria um novo arquivo. Salvar no mesmo caminho sobrescreve o original.

Problemas comuns e correções

java.io.FileNotFoundException

Verifique se o caminho para o .pptx arquivo está correto em relação ao diretório de trabalho. Use java.nio.file.Paths para construção robusta de caminhos:

import java.nio.file.Path;
import java.nio.file.Paths;

Path path = Paths.get("assets", "deck.pptx");
try (Presentation prs = new Presentation(path.toString())) {
    // ...
}

Exception: File format is not supported

A biblioteca suporta .pptx (Office Open XML) apenas. Legado .ppt (binary PowerPoint 97-2003) arquivos não são suportados.

Formas não possuem o método getTextFrame()

Algumas formas (Connectors, PictureFrames, GroupShapes) não possuem uma moldura de texto. Verifique com instanceof IAutoShape antes de fazer o cast e acessar o texto.

Perguntas Frequentes

O carregamento preserva todo o conteúdo original?

Sim. Partes XML desconhecidas são preservadas literalmente ao salvar em ida e volta. A biblioteca apenas serializa as partes do modelo de documento que entende e encaminha qualquer XML que não reconhece.

Posso carregar um PPTX protegido por senha?

Apresentações protegidas por senha (criptografadas) não são suportadas nesta edição.

O carregamento a partir de um InputStream é suportado?

Sim. O Presentation construtor aceita um InputStream:

import java.io.FileInputStream;

try (FileInputStream fis = new FileInputStream("deck.pptx");
     Presentation prs = new Presentation(fis)) {
    System.out.println("Slides: " + prs.getSlides().size());
}