Aspose.Slides FOSS
Java
如何在 Java 中加载演示文稿

如何在 Java 中加载演示文稿

Aspose.Slides FOSS for Java lets you open any .pptx 文件，检查其内容，并可以将其重新保存为 PPTX 或从中提取数据。本指南涵盖打开文件、遍历幻灯片、读取形状文本以及往返保存的过程。.

分步指南

步骤 1：添加 Maven 依赖 

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

步骤 2：打开现有演示文稿

将文件路径传递给 Presentation 构造函数。使用 try-with-resources 以确保清理。.

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);
}

源文件中未知的 XML 部分会原样保留：库永不删除它尚未理解的内容。.

步骤 3：检查幻灯片

遍历所有幻灯片并打印其形状数量：:

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");
    }
}

步骤 4：读取形状文本

遍历形状并从具有 … 的形状中读取文本。 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());
                }
            }
        }
    }
}

步骤 5：读取文档属性

从 … 访问核心文档属性。 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());
}

步骤 6：往返保存

检查或修改演示文稿后，将其保存回 PPTX：:

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

保存到不同路径会创建新文件。保存到相同路径会覆盖原文件。.

常见问题及解决方案

java.io.FileNotFoundException

检查指向 … 的路径 .pptx 文件相对于工作目录的路径是否正确。使用 java.nio.file.Paths 进行稳健的路径构建：:

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

该库支持 .pptx （Office Open XML）仅。旧版 .ppt （二进制 PowerPoint 97-2003）文件不受支持。.

形状没有 getTextFrame() 方法

某些形状（Connectors、PictureFrames、GroupShapes）没有文本框。请使用 … 检查 instanceof IAutoShape 在进行类型转换并访问文本之前。.

常见问答

加载是否会保留所有原始内容？?

是的。未知的 XML 部分在往返保存时会原样保留。库仅序列化它能够理解的文档模型部分，并直接转发任何未识别的 XML。.

我可以加载受密码保护的 PPTX 吗？?

此版本不支持受密码保护（加密）的演示文稿。.

是否支持从 InputStream 加载？?

是的。该 Presentation 构造函数接受一个 InputStream:

import java.io.FileInputStream;

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

另请参阅

 中文