介绍

Aspose.Slides FOSS for Java is now available on Maven Central: a free, MIT-licensed library for creating, reading, and editing PowerPoint .pptx 文件完全采用 Java，且不依赖 Microsoft Office 或任何专有运行时。.

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

关键特性

  • 完整的往返 PPTX 支持:：打开任意 .pptx 文件，修改其内容，并在不丢失库尚未理解的未知 XML 部分的情况下保存回去。.
  • 幻灯片管理:：使用 … 添加、删除和遍历幻灯片 prs.getSlides();；演示文稿在 … 之后以一张空白幻灯片开始 new Presentation().
  • 自动形状、表格和连接线:：通过 … 插入形状 slide.getShapes().addAutoShape(),，通过 … 插入表格数据 slide.getShapes().addTable(),，并通过 … 在形状之间插入可视连接线 slide.getShapes().addConnector().
  • 富文本格式化:：使用 … 对字符级别的文本进行格式化 PortionFormat:：通过 … 设置字体大小、粗体、斜体、下划线和 ARGB 颜色 FillType.SOLID 和 ColorFormat.
  • 填充类型: 应用 FillType.SOLID, GRADIENT, PATTERN, 或 PICTURE 填充到任何形状。.
  • 视觉效果: 外阴影、发光、柔和边缘、模糊、反射，以及内阴影 via shape.getEffectFormat().
  • 3D formatting: 倾斜、相机、灯光装置、材质，以及挤出深度 via shape.getThreeDFormat().
  • 演讲者备注: 通过将备注文本附加到每张幻灯片 via getNotesSlideManager().addNotesSlide().
  • 线程式评论: 添加带有作者元数据和幻灯片位置的评论。.
  • 嵌入式图像: 从文件路径、字节或 InputStream.
  • 文档属性: 读取和写入核心、应用和自定义属性。.

入门指南

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

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

文本格式示例

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 文件能够安全往返。.

另请参阅