介绍

Aspose.Slides FOSS for Java 现已在 Maven Central 上提供：一个免费、MIT 许可证的库，可在纯 Java 环境中创建、读取和编辑 PowerPoint .pptx 文件，无需依赖 Microsoft Office 或任何专有运行时。

该库面向需要以编程方式生成或操作演示文稿文件的开发者：从数据自动化生成幻灯片、从上传的 PPTX 文件提取文本和元数据、构建基于演示的报告流水线，或将演示创建嵌入到 Spring Boot 应用中。由于 aspose-slides-foss 是纯 Java，它在 Windows、macOS、Linux 和 Docker 容器上部署方式完全相同。

关键特性

  • Full round-trip PPTX support: 打开任何 .pptx 文件，修改其内容，并保存回去，而不会丢失库尚未理解的未知 XML 部分。
  • Slides management: 使用 prs.getSlides() 添加、删除和遍历幻灯片；在 new Presentation() 之后，演示文稿以一张空白幻灯片开始。
  • AutoShapes, Tables, and Connectors: 通过 slide.getShapes().addAutoShape() 插入形状，通过 slide.getShapes().addTable() 插入表格数据，通过 slide.getShapes().addConnector() 在形状之间插入可视连接线。
  • Rich text formatting: 使用 PortionFormat 在字符级别格式化文本：字体大小、粗体、斜体、下划线，以及通过 FillType.SOLID 和 ColorFormat 设置 ARGB 颜色。
  • Fill types: 对任意形状应用 FillType.SOLID、GRADIENT、PATTERN 或 PICTURE 填充。
  • Visual effects: 通过 shape.getEffectFormat() 实现外阴影、发光、柔边、模糊、反射和内阴影等视觉效果。
  • 3D formatting: 通过 shape.getThreeDFormat() 实现斜角、摄像机、灯光装置、材质和拉伸深度等 3D 格式化。
  • Speaker notes: 通过 getNotesSlideManager().addNotesSlide() 为每张幻灯片附加备注文本。
  • Threaded comments: 添加带有作者元数据和幻灯片位置的线程式评论。
  • Embedded images: 从文件路径、字节或 InputStream 嵌入图像。
  • Document properties: 读取和写入核心、应用程序和自定义属性。

入门

添加 Maven 依赖。需要 Java 21 或更高版本。

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

使用形状创建您的第一个演示文稿并保存它：

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.NullableBool;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.drawing.Color;

public class HelloSlides {
    public static void main(String[] args) {
        try (Presentation prs = new Presentation()) {
            ISlide slide = prs.getSlides().get(0);
            IAutoShape shape = slide.getShapes().addAutoShape(
                ShapeType.RECTANGLE, 50, 50, 400, 120
            );
            shape.addTextFrame("Hello from Aspose.Slides FOSS!");
            prs.save("hello.pptx");
        }
    }
}

始终在 try-with-resources 块中使用 Presentation；这可确保在块退出时释放所有内部资源。

文本格式示例

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;
import org.aspose.slides.foss.ITextFrame;
import org.aspose.slides.foss.IPortionFormat;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.FillType;
import org.aspose.slides.foss.NullableBool;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.drawing.Color;

try (Presentation prs = new Presentation()) {
    IAutoShape shape = prs.getSlides().get(0).getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 500, 150
    );
    ITextFrame tf = shape.addTextFrame("Bold heading in corporate blue");
    IPortionFormat fmt = tf.getParagraphs().get(0).getPortions().get(0).getPortionFormat();
    fmt.setFontHeight(28);
    fmt.setFontBold(NullableBool.TRUE);
    fmt.getFillFormat().setFillType(FillType.SOLID);
    fmt.getFillFormat().getSolidFillColor().setColor(new Color(0, 70, 127));
    prs.save("formatted.pptx");
}

当前限制

以下区域在此版本中抛出 UnsupportedOperationException：

  • 图表、SmartArt 和 OLE 对象
  • 动画和幻灯片切换
  • 导出为 PDF、HTML、SVG 或图像格式
  • 超链接、操作设置、VBA 宏和数字签名

在加载过程中遇到的未知 XML 部分在保存时会原样保留，因此其他工具生成的 PPTX 文件能够安全往返。

另请参阅