在 Android 上保存演示文稿

概述

Open Presentations on Android 说明了如何使用 Presentation 类打开演示文稿。本文解释了如何创建和保存演示文稿。Presentation 类包含演示文稿的内容。无论是从头创建演示文稿还是修改现有演示文稿，完成后都需要保存。使用 Aspose.Slides for Android，您可以保存到文件或流。本文说明了保存演示文稿的不同方式。

将演示文稿保存到文件

通过调用 Presentation 类的 save 方法将演示文稿保存到文件。将文件名和保存格式传递给该方法。以下示例展示了如何使用 Aspose.Slides 保存演示文稿。

// 实例化表示演示文稿文件的 Presentation 类。
Presentation presentation = new Presentation();
try {
    // 在此处执行一些操作...

    // 将演示文稿保存到文件。
    presentation.save("Output.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

将演示文稿保存到流

您可以通过向 Presentation 类的 save 方法传递输出流来将演示文稿保存到流。演示文稿可以写入多种流类型。在下面的示例中，我们创建一个新演示文稿并将其保存到文件流。

// 实例化表示演示文稿文件的 Presentation 类。
Presentation presentation = new Presentation();
try {
    OutputStream fileStream = new FileOutputStream("Output.pptx");
    try {
        // 将演示文稿保存到流中。
        presentation.save(fileStream, SaveFormat.Pptx);
    } finally {
        fileStream.close();
    }
} finally {
    presentation.dispose();
}

使用预定义视图类型保存演示文稿

Aspose.Slides 允许您通过 ViewProperties 类设置 PowerPoint 打开生成的演示文稿时的初始视图。使用带有 ViewType 枚举值的 setLastView 方法。

Presentation presentation = new Presentation();
try {
    presentation.getViewProperties().setLastView(ViewType.SlideMasterView);
    presentation.save("SlideMasterView.pptx", SaveFormat.Pptx);
} finally {
    presentation.dispose();
}

以严格的 Office Open XML 格式保存演示文稿

Aspose.Slides 允许您以严格的 Office Open XML 格式保存演示文稿。保存时使用 PptxOptions 类并设置其 conformance 属性。如果将其设为 Conformance.Iso29500_2008_Strict，输出文件将以严格的 Office Open XML 格式保存。

下面的示例创建一个演示文稿并以严格的 Office Open XML 格式保存。

PptxOptions options = new PptxOptions();
options.setConformance(Conformance.Iso29500_2008_Strict);

// 实例化表示演示文稿文件的 Presentation 类。
Presentation presentation = new Presentation();
try {
    // 以严格的 Office Open XML 格式保存演示文稿。
    presentation.save("StrictOfficeOpenXml.pptx", SaveFormat.Pptx, options);
} finally {
    presentation.dispose();
}

在 Zip64 模式下以 Office Open XML 格式保存演示文稿

Office Open XML 文件是 ZIP 存档，对任何文件的未压缩大小、压缩后大小以及整个存档的总大小都有 4 GB（2^32 字节）的限制，并且限制存档中的文件数为 65 535（2^16‑1）个。ZIP64 格式扩展将这些限制提升至 2^64。

IPptxOptions.setZip64Mode 方法允许您在保存 Office Open XML 文件时选择何时使用 ZIP64 格式扩展。

此方法可与以下模式一起使用：

如果必要仅在演示文稿超过上述限制时使用 ZIP64 格式扩展。这是默认模式。
永不从不使用 ZIP64 格式扩展。
始终始终使用 ZIP64 格式扩展。

下面的代码演示了如何在启用 ZIP64 格式扩展的情况下将演示文稿保存为 PPTX：

PptxOptions pptxOptions = new PptxOptions();
pptxOptions.setZip64Mode(Zip64Mode.Always);

Presentation presentation = new Presentation("Sample.pptx");
try {
    presentation.save("OutputZip64.pptx", SaveFormat.Pptx, pptxOptions);
} finally {
    presentation.dispose();
}

NOTE

当使用 Zip64Mode.Never 保存时，如果演示文稿无法以 ZIP32 格式保存，将抛出 PptxException。

保存演示文稿时不刷新缩略图

PptxOptions.setRefreshThumbnail 方法控制保存 PPTX 时是否生成缩略图：

设置为 true 时，保存过程中会刷新缩略图。这是默认值。
设置为 false 时，保留当前缩略图。如果演示文稿没有缩略图，则不会生成。

下面的代码将演示文稿保存为 PPTX，且不刷新其缩略图。

PptxOptions pptxOptions = new PptxOptions();
pptxOptions.setRefreshThumbnail(false);

Presentation presentation = new Presentation("Sample.pptx");
try {
    presentation.save("Output.pptx", SaveFormat.Pptx, pptxOptions);
}
finally {
    presentation.dispose();
}

Info

此选项有助于减少以 PPTX 格式保存演示文稿所需的时间。

以百分比方式获取保存进度更新

IProgressCallback 接口通过 ISaveOptions 接口公开的 setProgressCallback 方法以及抽象的 SaveOptions 类使用。使用 setProgressCallback 传入实现了 IProgressCallback 的对象，即可在保存过程中以百分比形式接收进度更新。

下面的代码片段展示了如何使用 IProgressCallback。

ISaveOptions saveOptions = new PdfOptions();
saveOptions.setProgressCallback(new ExportProgressHandler());

Presentation presentation = new Presentation("Sample.pptx");
try {
    presentation.save("Output.pdf", SaveFormat.Pdf, saveOptions);
} finally {
    presentation.dispose();
}

class ExportProgressHandler implements IProgressCallback {
    public void reporting(double progressValue) {
        // 在此使用进度百分比值。
        int progress = (int) progressValue;

        System.out.println(progress + "% of the file has been converted.");
    }
}

Info

Aspose 开发了一个使用其 API 的免费 PowerPoint Splitter 应用。该应用可通过将选定幻灯片另存为新的 PPTX 或 PPT 文件，将演示文稿拆分为多个文件。

FAQ

是否支持“快速保存”（增量保存）仅写入更改？

不支持。每次保存都会创建完整的目标文件，未实现增量“快速保存”。

从多个线程保存同一 Presentation 实例是否线程安全？

不安全。Presentation 实例 不是线程安全的，请在单个线程中进行保存。

保存时超链接和外部链接文件会怎样？

超链接会被保留。外部链接的文件（例如通过相对路径引用的视频）不会自动复制——请确保引用的路径仍然可访问。

我可以设置/保存文档元数据（作者、标题、公司、日期）吗？

可以。标准的文档属性已受支持，保存时会写入文件。

转换演示文稿在 Android 上管理幻灯片放映