Aspose.Slides FOSS
Java
如何在 Java 中创建演示文稿

如何在 Java 中创建演示文稿

Aspose.Slides FOSS for Java 让您完全在 Java 中创建 PowerPoint 演示文稿，无需依赖 Microsoft Office。本指南展示了如何创建新演示文稿、添加幻灯片和形状、格式化文本以及保存结果。

分步指南

步骤 1：添加 Maven 依赖

将 Aspose.Slides FOSS 添加到您的 pom.xml。需要 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;

Presentation prs = new Presentation();
prs.dispose();
System.out.println("Aspose.Slides FOSS ready");

步骤 2：导入所需的类

导入用于保存的 Presentation 类和 SaveFormat 枚举。

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.export.SaveFormat;
import org.aspose.slides.foss.ShapeType;
import org.aspose.slides.foss.ISlide;
import org.aspose.slides.foss.IAutoShape;

所有形状类型常量位于 org.aspose.slides.foss.ShapeType。格式枚举（FillType，NullableBool）也位于 org.aspose.slides.foss。

步骤 3：创建演示文稿

使用 new Presentation() 并将其包装在 try-with-resources 中。一个新的演示文稿以一个空白幻灯片开始。

import org.aspose.slides.foss.Presentation;
import org.aspose.slides.foss.export.SaveFormat;

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

重要： 始终使用 try-with-resources 或在 finally 块中调用 prs.dispose()。否则资源将无法正确释放。

步骤 4：访问幻灯片

第一张幻灯片的索引是 0。空白演示文稿恰好有一张幻灯片。

try (Presentation prs = new Presentation()) {
    ISlide slide = prs.getSlides().get(0);  // zero-based index
    System.out.println("Slide at index 0: " + slide);
    prs.save("output.pptx", SaveFormat.PPTX);
}

步骤 5：添加形状

使用 slide.getShapes().addAutoShape() 添加 AutoShape。参数为 (shapeType, x, y, width, height)，全部以点为单位（1 点 = 1/72 英寸；标准幻灯片为 720 x 540 pt）。

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.ITable;
import org.aspose.slides.foss.ILayoutSlide;
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()) {
    ISlide slide = prs.getSlides().get(0);

    // Rectangle at (50, 50) with 400 wide and 120 tall
    IAutoShape shape = slide.getShapes().addAutoShape(
        ShapeType.RECTANGLE, 50, 50, 400, 120
    );

    // Attach a text frame
    shape.addTextFrame("Hello from Aspose.Slides FOSS!");

    prs.save("with-shape.pptx", SaveFormat.PPTX);
}

第6步：保存演示文稿

在 try 块退出之前调用 prs.save(path, SaveFormat.PPTX)。PPTX 是唯一受支持的输出格式。

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

文件以原子方式写入；如果在此调用之前发生错误，则不会创建输出文件。

完整工作示例

以下程序创建了一个包含两张幻灯片的演示文稿，第一张幻灯片上有标题形状，第二张幻灯片上有表格。

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.ITable;
import org.aspose.slides.foss.ILayoutSlide;
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 CreatePresentation {
    public static void main(String[] args) {
        try (Presentation prs = new Presentation()) {
            // --- Slide 1: title shape ---
            ISlide slide1 = prs.getSlides().get(0);
            IAutoShape title = slide1.getShapes().addAutoShape(
                ShapeType.RECTANGLE, 40, 40, 640, 80
            );
            ITextFrame tf = title.addTextFrame("Q1 Results: Executive Summary");
            IPortionFormat fmt = tf.getParagraphs().get(0)
                .getPortions().get(0).getPortionFormat();
            fmt.setFontHeight(32);
            fmt.setFontBold(NullableBool.TRUE);
            fmt.getFillFormat().setFillType(FillType.SOLID);
            fmt.getFillFormat().getSolidFillColor().setColor(
                Color.fromArgb(255, 0, 70, 127)
            );

            // --- Slide 2: table ---
            prs.getSlides().addEmptySlide(prs.getLayoutSlides().get(0));
            ISlide slide2 = prs.getSlides().get(1);
            ITable table = slide2.getShapes().addTable(
                40, 40,
                new double[]{200.0, 120.0, 120.0},
                new double[]{40.0, 40.0, 40.0}
            );
            String[] headers = {"Region", "Revenue", "Growth"};
            String[][] data = {
                {"North", "$1.2M", "+8%"},
                {"South", "$0.9M", "+4%"},
            };
            for (int col = 0; col < headers.length; col++) {
                table.getRows().get(0).get(col).getTextFrame().setText(headers[col]);
            }
            for (int row = 0; row < data.length; row++) {
                for (int col = 0; col < data[row].length; col++) {
                    table.getRows().get(row + 1).get(col)
                        .getTextFrame().setText(data[row][col]);
                }
            }

            prs.save("q1-results.pptx", SaveFormat.PPTX);
        }
        System.out.println("Saved q1-results.pptx");
    }
}

常见问题及解决方案

IllegalStateException: Presentation already disposed

您在 try-with-resources 块退出后调用 Presentation 对象的方法。始终将所有工作放在 try 块内部。

UnsupportedOperationException 保存时

当尝试保存为除 PPTX 之外的格式，或使用不受支持的功能（例如图表或动画）时，会出现此情况。

形状出现在可见幻灯片区域之外

幻灯片默认尺寸为 720 x 540 点。保留 x + width <= 720 和 y + height <= 540。

常见问题

默认幻灯片尺寸是多少？

新的 Presentation() 会创建标准 10 x 7.5 英寸（720 x 540 点）大小的幻灯片。此版本尚不支持更改幻灯片大小。

我可以添加多个幻灯片吗？

是的。调用 prs.getSlides().addEmptySlide(prs.getLayoutSlides().get(0)) 来追加一个空白幻灯片，并通过索引访问它：

prs.getSlides().addEmptySlide(prs.getLayoutSlides().get(0));
ISlide slide2 = prs.getSlides().get(1);

我可以打开现有文件并添加幻灯片吗？

是：

try (Presentation prs = new Presentation("existing.pptx")) {
    prs.getSlides().addEmptySlide(prs.getLayoutSlides().get(0));
    prs.save("existing.pptx", SaveFormat.PPTX);
}

我可以保存为哪些格式？

仅支持 SaveFormat.PPTX。此版本不提供导出为 PDF、HTML、SVG 或图像的功能。

另请参阅

 中文