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

如何在 Java 中加载演示文稿

Aspose.Slides FOSS for Java 允许您打开任何 .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）文件。

Shapes 没有 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());
}

另请参阅

 中文