从演示文稿中提取文本

开发人员需要从演示文稿中提取文本并不罕见。为此，您需要从演示文稿中的所有幻灯片上的所有形状中提取文本。本文解释了如何使用 Aspose.Slides 从 Microsoft PowerPoint PPTX 演示文稿中提取文本。

从幻灯片中提取文本

Aspose.Slides for Java 提供了 SlideUtil 类。该类公开了一些重载的静态方法，用于从演示文稿或幻灯片中提取全部文本。要从 PPTX 演示文稿中的幻灯片提取文本，请使用 SlideUtil 类公开的 getAllTextBoxes 重载静态方法。该方法接受 Slide 对象作为参数。执行时，Slide 方法扫描传递的幻灯片中的所有文本，并返回 TextFrame 对象数组。这意味着与文本相关的任何文本格式信息都是可用的。以下代码从演示文稿的第一张幻灯片中提取所有文本：

//实例化表示 PPTX 文件的 Presentation 类
Presentation pres = new Presentation("demo.pptx");
try {
    for (ISlide slide : pres.getSlides()) 
    {
        //从 PPTX 中的所有幻灯片获取 ITextFrame 对象数组
        ITextFrame[] textFramesPPTX = SlideUtil.getAllTextBoxes(slide);

        //遍历 TextFrames 数组
        for (int i = 0; i < textFramesPPTX.length; i++) {
            //遍历当前 ITextFrame 中的段落
            for (IParagraph para : textFramesPPTX[i].getParagraphs()) {
                //遍历当前 IParagraph 中的部分
                for (IPortion port : para.getPortions()) {
                    //显示当前部分中的文本
                    System.out.println(port.getText());

                    //显示文本的字体高度
                    System.out.println(port.getPortionFormat().getFontHeight());

                    //显示文本的字体名称
                    if (port.getPortionFormat().getLatinFont() != null)
                        System.out.println(port.getPortionFormat().getLatinFont().getFontName());
                }
            }
        }
    }
} finally {
    pres.dispose();
}

从演示文稿中提取文本

要扫描整个演示文稿中的文本，请使用 SlideUtil 类公开的 getAllTextFrames 静态方法。它接受两个参数：

首先，一个 Presentation 对象，表示正在提取文本的演示文稿。
其次，一个布尔值，确定是否在从演示文稿扫描文本时包含主幻灯片。该方法返回包含文本格式信息的 TextFrame 对象数组。下面的代码扫描演示文稿中的文本和格式信息，包括主幻灯片。

//实例化表示 PPTX 文件的 Presentation 类
Presentation pres = new Presentation("demo.pptx");
try {
    //从 PPTX 中的所有幻灯片获取 ITextFrame 对象数组
    ITextFrame[] textFramesPPTX = SlideUtil.getAllTextFrames(pres, true);

    //遍历 TextFrames 数组
    for (int i = 0; i < textFramesPPTX.length; i++) 
    {
        //遍历当前 ITextFrame 中的段落
        for (IParagraph para : textFramesPPTX[i].getParagraphs())
        {
            //遍历当前 IParagraph 中的部分
            for (IPortion port : para.getPortions())
            {
                //显示当前部分中的文本
                System.out.println(port.getText());

                //显示文本的字体高度
                System.out.println(port.getPortionFormat().getFontHeight());

                //显示文本的字体名称
                if (port.getPortionFormat().getLatinFont() != null)
                    System.out.println(port.getPortionFormat().getLatinFont().getFontName());
            }
        }
    }
} finally {
    pres.dispose();
}

分类和快速文本提取

Presentation 类中添加了新的静态方法 getPresentationText。此方法有三个重载：

public IPresentationText getPresentationText(String file, int mode);
public IPresentationText getPresentationText(InputStream stream, int mode);
public IPresentationText getPresentationText(InputStream stream, int mode, ILoadOptions options);

TextExtractionArrangingMode 枚举参数指示组织文本结果输出的模式，可以设置为以下值：

Unarranged - 原始文本，不考虑在幻灯片上的位置
Arranged - 文本按幻灯片上的相同顺序定位

Unarranged 模式可以在速度至关重要时使用，它比 Arranged 模式更快。

IPresentationText 表示从演示文稿中提取的原始文本。它包含 getSlidesText 方法，该方法返回 ISlideText 对象数组。每个对象表示相应幻灯片上的文本。 ISlideText 对象具有以下方法：

ISlideText.getText - 幻灯片形状上的文本
ISlideText.getMasterText - 此幻灯片在母版页形状上的文本
ISlideText.getLayoutText - 此幻灯片在布局页形状上的文本
ISlideText.getNotesText - 此幻灯片在备注页形状上的文本

还有一个 SlideText 类，实现了 ISlideText 接口。

新的 API 可以像这样使用：

IPresentationText text1 = PresentationFactory.getInstance().getPresentationText("presentation.pptx", TextExtractionArrangingMode.Unarranged);
System.out.println(text1.getSlidesText()[0].getText());
System.out.println(text1.getSlidesText()[0].getLayoutText());
System.out.println(text1.getSlidesText()[0].getMasterText());
System.out.println(text1.getSlidesText()[0].getNotesText());

上标和下标演示文稿本地化