在 Android 上检索和更新演示文稿信息

本页内容简介

使用 Java 探索 PowerPoint 和 OpenDocument 演示文稿中的幻灯片、结构和元数据，以获得更快速的洞察和更智能的内容审计。

概述

Aspose.Slides 可以识别演示文稿的格式并读取其文档元数据，而无需创建完整的演示文稿对象模型。当您需要对文件进行分类、建立清单或在决定是否加载和处理演示文稿内容之前检查属性时，这非常有用。

本文演示了通过PresentationFactory和IPresentationInfo进行轻量级检查，以及通过IDocumentProperties进行有针对性的更新。

检查演示文稿格式

使用PresentationFactory.getPresentationInfo可在不创建Presentation实例的情况下检查文件。IPresentationInfo.getLoadFormat方法报告检测到的格式，例如 PPTX、PPT 或 ODP。

import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.LoadFormat;
import com.aspose.slides.PresentationFactory;

String[] fileNames = { "pres.pptx", "pres.ppt", "pres.odp" };

for (String fileName : fileNames) {
    IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(fileName);
    int loadFormat = presentationInfo.getLoadFormat();
    String formatName = "Other (" + loadFormat + ")";

    if (loadFormat == LoadFormat.Pptx) {
        formatName = "PPTX";
    } else if (loadFormat == LoadFormat.Ppt) {
        formatName = "PPT";
    } else if (loadFormat == LoadFormat.Odp) {
        formatName = "ODP";
    }

    System.out.println(fileName + ": " + formatName);
}

构建轻量级演示文稿清单

当处理大量演示文稿文件时，您可能需要一个紧凑的清单用于验证、索引或文档管理系统。在这种情况下，使用PresentationFactory.getPresentationInfo获取IPresentationInfo对象，然后调用IPresentationInfo.readDocumentProperties读取文档元数据。此方法不会创建Presentation实例，也不需要遍历完整的演示文稿对象模型。

由IDocumentProperties公开的扩展属性提供以下清单值：

方法	清单值
getSlides	幻灯片的总数。
getHiddenSlides	隐藏幻灯片的数量。
getNotes	包含备注的幻灯片数量。
getParagraphs	段落总数（如有）。
getWords	单词总数。
getMultimediaClips	音频和视频剪辑的总数。

以下示例在不创建Presentation对象的情况下读取这些值并输出紧凑的清单。它还结合getHeadingPairs和getTitlesOfParts显示内容组，如字体、主题和幻灯片标题。

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.IHeadingPair;
import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.LoadFormat;
import com.aspose.slides.PresentationFactory;
import java.nio.file.Paths;

String filePath = "sample.pptx";
IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(filePath);
IDocumentProperties documentProperties = presentationInfo.readDocumentProperties();

int loadFormat = presentationInfo.getLoadFormat();
String formatName = "Other (" + loadFormat + ")";

if (loadFormat == LoadFormat.Pptx) {
    formatName = "PPTX";
} else if (loadFormat == LoadFormat.Ppt) {
    formatName = "PPT";
} else if (loadFormat == LoadFormat.Odp) {
    formatName = "ODP";
}

System.out.println("File: " + Paths.get(filePath).getFileName());
System.out.println("Format: " + formatName);
System.out.println("Title: " + documentProperties.getTitle());
System.out.println("Author: " + documentProperties.getAuthor());
System.out.println("Statistics:");
System.out.println("  Slides: " + documentProperties.getSlides());
System.out.println("  Hidden slides: " + documentProperties.getHiddenSlides());
System.out.println("  Slides with notes: " + documentProperties.getNotes());
System.out.println("  Paragraphs: " + documentProperties.getParagraphs());
System.out.println("  Words: " + documentProperties.getWords());
System.out.println("  Multimedia clips: " + documentProperties.getMultimediaClips());

IHeadingPair[] headingPairs = documentProperties.getHeadingPairs();
String[] titlesOfParts = documentProperties.getTitlesOfParts();
headingPairs = headingPairs != null ? headingPairs : new IHeadingPair[0];
titlesOfParts = titlesOfParts != null ? titlesOfParts : new String[0];
int partIndex = 0;

if (headingPairs.length == 0 || titlesOfParts.length == 0) {
    System.out.println("Content groups: not available");
} else {
    System.out.println("Content groups:");

    for (IHeadingPair headingPair : headingPairs) {
        System.out.println("  " + headingPair.getName() + " (" + headingPair.getCount() + ")");

        for (int partOffset = 0; partOffset < headingPair.getCount() && partIndex < titlesOfParts.length; partOffset++) {
            System.out.println("    - " + titlesOfParts[partIndex]);
            partIndex++;
        }
    }

    if (partIndex < titlesOfParts.length) {
        System.out.println("  Other parts:");

        while (partIndex < titlesOfParts.length) {
            System.out.println("    - " + titlesOfParts[partIndex]);
            partIndex++;
        }
    }
}

每个IHeadingPair提供组名以及该组中的项目数量。IDocumentProperties.getTitlesOfParts返回一个扁平的有序数组，因此需要按照每个标题对指定的连续标题数量进行消费。

存储的元数据与格式限制

由IPresentationInfo.readDocumentProperties返回的清单属性反映了源文档中可用的元数据。Aspose.Slides 不会加载并遍历演示文稿对象模型来重新计算这些值。缺失的属性将使用默认值表示，如果最后保存文件的应用程序未更新其文档属性，则存储的值可能已过时。

PPTX: 此格式提供幻灯片、备注、隐藏幻灯片、段落、单词和多媒体计数的扩展文档属性，以及标题对和部件标题。可用性取决于文档生成者写入了哪些属性。
PPT: 二进制格式可以存储相应的文档摘要属性。如果属性缺失或未被文档生成者刷新，Aspose.Slides 将返回其存储的或默认的值，而不是从幻灯片计算。
ODP: OpenDocument 元数据提供一般文档统计信息，如页数、段落数和单词数，但这些值并未映射到每个 PowerPoint 特定的扩展属性。隐藏幻灯片、备注幻灯片、多媒体、标题对和部件标题的元数据可能不可用，清单属性可能返回默认值。不要将零值或空数组视为相应内容不存在的权威证明。

在进行清单和初步检查时使用轻量级元数据方法。当结果必须反映内存中的更改或需要验证实际演示文稿内容时，请加载演示文稿并检查其实时对象模型。

更新演示文稿属性

由IPresentationInfo.readDocumentProperties返回的属性也可以在不创建Presentation实例的情况下进行更改。使用IPresentationInfo.updateDocumentProperties应用更改，然后使用IPresentationInfo.writeBindedPresentation写入绑定的演示文稿。

下图显示了原始文档属性。

PowerPoint 演示文稿的原始文档属性

下面的示例更改标题和最后保存时间，并将结果写入新文件：

import com.aspose.slides.IDocumentProperties;
import com.aspose.slides.IPresentationInfo;
import com.aspose.slides.PresentationFactory;
import java.io.FileOutputStream;
import java.io.OutputStream;
import java.util.Date;

String sourceFile = "sample.pptx";
String outputFile = "sample_with_updated_properties.pptx";
IPresentationInfo presentationInfo = PresentationFactory.getInstance().getPresentationInfo(sourceFile);
IDocumentProperties documentProperties = presentationInfo.readDocumentProperties();

documentProperties.setTitle("Quarterly sales report");
documentProperties.setLastSavedTime(new Date());

presentationInfo.updateDocumentProperties(documentProperties);
try (OutputStream outputStream = new FileOutputStream(outputFile)) {
    presentationInfo.writeBindedPresentation(outputStream);
}

PowerPoint 演示文稿的已更改文档属性

有用的链接

有关相关的安全检查和保护设置，请参阅以下文章：

常见问题

如何检查字体是否已嵌入以及哪些字体已嵌入？

加载演示文稿并使用Presentation.getFontsManager。调用IFontsManager.getEmbeddedFonts获取已嵌入的字体，调用IFontsManager.getFonts获取演示文稿使用的字体。比较两者结果即可找出渲染所需但未嵌入的字体。

如何快速判断文件是否包含隐藏幻灯片以及数量？

当存储的文档元数据足够时，使用PresentationFactory.getPresentationInfo和IPresentationInfo.readDocumentProperties读取IDocumentProperties.getHiddenSlides。这适用于轻量级清单。如果演示文稿已在内存中修改，存储的元数据可能缺失或已过时，或者需要验证实时值，则遍历Presentation.getSlides并检查每个幻灯片的ISlide.getHidden方法。

我能否检测是否使用了自定义幻灯片大小和方向，以及它们是否与默认值不同？

可以。加载演示文稿并调用Presentation.getSlideSize。使用ISlideSize.getType、ISlideSize.getSize和ISlideSize.getOrientation将当前设置与预期的预设和尺寸进行比较。

有没有快速方法查看图表是否引用外部数据源？

有。定位每个Chart并调用IChartData.getDataSourceType。对于外部工作簿，调用IChartData.getExternalWorkbookPath。数据源类型和路径可识别外部引用，但要验证目标是否可用需进行单独的资源检查。

如何评估可能导致渲染或 PDF 导出变慢的“重”幻灯片？

没有单一的复杂度属性。遍历Presentation.getSlides以及每个幻灯片的IBaseSlide.getShapes集合。使用形状数量以及大图像、效果、动画或多媒体的存在作为筛选信号，并在将幻灯片视为确认的性能瓶颈之前进行代表性的渲染或导出测量。

在 Android 上打开演示文稿在 Android 上高效合并演示文稿