Apache POI PPT 快速指南

---

---

Apache POI PPT - 概述

很多时候，软件应用程序需要生成 Microsoft Office 文件格式的报表。有时，甚至期望应用程序接收 MS-Office 文件作为输入数据。

任何想要生成 MS Office 文件作为输出的 Java 程序员都必须使用预定义的只读 API 来实现。

什么是 Apache POI？

Apache POI 是一个流行的 API，允许程序员使用 Java 程序创建、修改和显示 MS-Office 文件。它是一个由 Apache 软件基金会开发和分发的开源库。它包含用于解码用户输入数据或将文件解码为 MS Office 文档的类和方法。

Apache POI 的组件

Apache POI 包含用于处理所有 MS-Office 的 OLE2 复合文档的类和方法。此 API 的组件列表如下：

• POIFS (Poor Obfuscation Implementation File System) - 此组件是所有其他 POI 元素的基础。它用于显式读取不同的文件。

• HSSF (Horrible SpreadSheet Format) - 用于读取和写入 MS-Excel 文件的 .xls 格式。

• XSSF (XML SpreadSheet Format) - 用于 MS-Excel 的 .xlsx 文件格式。

• HPSF (Horrible Property Set Format) - 用于提取 MS-Office 文件的属性集。

• HWPF (Horrible Word Processor Format) - 用于读取和写入 MS-Word 的 .doc 扩展名文件。

• XWPF (XML Word Processor Format) - 用于读取和写入 MS-Word 的 .docx 扩展名文件。

• HSLF (Horrible Slide Layout Format) - 用于读取、创建和编辑 PowerPoint 演示文稿。

• HDGF (Horrible DiaGram Format) - 包含用于 MS-Visio 二进制文件的类和方法。

• HPBF (Horrible PuBlisher Format) - 用于读取和写入 MS-Publisher 文件。

本教程指导您完成使用 Java 处理 Microsoft PowerPoint 演示文稿的过程。因此，讨论仅限于XSLF 组件。

注意 - 旧版本的 POI 支持 doc、xls、ppt 等二进制文件格式。3.5 版及更高版本，POI 支持 MS-Office 的 OOXML 文件格式，例如 docx、xlsx、pptx 等。

Java PPT API 的版本

本章将带您了解 Java PowerPoint API 的一些版本及其功能。许多供应商提供与 Java PPT 相关的 API；本章将介绍其中一些。

Aspose Slides for Java

Aspose slides for Java 是一个纯许可的 Java PPT API，由供应商Aspose开发和分发。此 API 的最新版本是 8.1.2，于 2014 年 7 月发布。它是一个丰富且重量级的 API（普通 Java 类和 AWT 类的组合），用于设计可以读取、写入和管理幻灯片的 PPT 组件。

此 API 的常用用途如下：

• 构建动态演示文稿
• 渲染和打印高保真演示文稿
• 生成、编辑、转换和打印演示文稿

Apache POI

Apache POI 是 Apache 软件基金会提供的 100% 开源库。大多数小型和中型应用程序开发人员都严重依赖 Apache POI (HSLF + XSLF)。它支持 PPT 库的所有基本功能；但是，渲染和文本提取是其主要功能。以下是 Apache POI for PPT 的架构。

Apache POI PPT - 安装

本章将指导您完成在基于 Windows 和 Linux 的系统上设置 Apache POI 的过程。Apache POI 可以轻松安装并与您当前的 Java 环境集成，只需按照几个简单的步骤即可完成，无需任何复杂的设置过程。安装时需要用户管理。

系统要求

现在让我们继续安装 Apache POI 的步骤。

步骤 1 - 验证您的 Java 安装

首先，您需要在系统上安装 Java 软件开发工具包 (SDK)。要验证这一点，请根据您正在使用的平台执行以下两个命令中的任何一个。

如果 Java 安装已正确完成，则它将显示您 Java 安装的当前版本和规范。示例输出如下表所示。

• 我们假设本教程的读者在他们的系统上安装了 Java SDK 11.0.11 版本。

• 如果您没有 Java SDK，请从www.oracle.com/technetwork/java/javase/downloads/index.html下载其当前版本并安装。

步骤 2 - 设置您的 Java 环境

设置环境变量 JAVA_HOME 以指向 Java 安装在您计算机上的基本目录位置。例如：

将 Java 编译器位置的完整路径附加到系统路径。

如上所述，从命令提示符执行命令java -version。

步骤 3 - 安装 Apache POI 库

从https://poi.apache.org/download.html下载最新版本的 Apache POI 并将其内容解压缩到一个文件夹中，从中可以将所需的库链接到您的 Java 程序。让我们假设这些文件收集在 C 盘上的一个文件夹中。

将所需jars的完整路径添加到 CLASSPATH，如下所示。

pom.xml

以下是本教程中运行程序的 pom.xml 文件。

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
   <modelVersion>4.0.0</modelVersion>
   <groupId>ApachePoiPPT</groupId>
   <artifactId>ApachePoiPPT</artifactId>
   <version>0.0.1-SNAPSHOT</version>
   <build>
      <sourceDirectory>src</sourceDirectory>
      <plugins>
         <plugin>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.8.1</version>
            <configuration>
               <source>11</source>
               <target>11</target>
               <compilerArgs>
                  <arg>--add-modules</arg>
                  <arg>java.se,java.desktop</arg>
               </compilerArgs>
            </configuration>
         </plugin>
      </plugins>
   </build>
   <dependencies>  
      <dependency>
         <groupId>org.apache.poi</groupId>
         <artifactId>poi</artifactId>
         <version>5.1.0</version>
      </dependency>
      <dependency>
         <groupId>org.apache.poi</groupId>
         <artifactId>poi-ooxml</artifactId>
         <version>5.1.0</version>
      </dependency>    
   </dependencies>
</project>

Apache POI PPT - 类和方法

在本章中，我们将学习 Apache POI API 中的一些类和方法，这些类和方法对于使用 Java 程序处理 PPT 文件至关重要。

演示文稿

要创建和管理演示文稿，您有一个名为 XMLSlideShow 的类，位于org.apache.poi.xslf.usermodel包中。下面是一些此类的重要方法和构造函数。

类 - XMLSlideShow

包 - org.apache.poi.xslf.usermodel

幻灯片

要创建和管理演示文稿中的幻灯片，可以使用XSLFSlide类的各种方法。下面提到的是此类的一些重要方法。

类 - XSLFSlide

包 - org.apache.poi.xslf.usermodel

幻灯片母版

它是演示文稿的组件，具有不同的幻灯片布局。XSLFSlideMaster类允许您访问它。下面提到的是此类的一些重要方法。

类 - XSLFSlideMaster

包 - org.apache.poi.xslf.usermodel

幻灯片布局

POI 库有一个名为XSLFSlideLayout的类，您可以使用它来管理幻灯片的布局。

类 - XSLFSlideLayout

包 - org.apache.poi.xslf.usermodel

文本段落

您可以使用XSLFTextParagraph类向幻灯片写入内容。下面提到的是此类的一些重要方法。

类 - XSLFTextParagraph

包 - org.apache.poi.xslf.usermodel

文本运行 (Text Run)

这是文本主体中最底层的文本分割单元。您可以使用XSLFTextRun类来管理段落的文本运行。下面列出了一些此类别的重要方法。

类 - XSLFTextParagraph

包 - org.apache.poi.xslf.usermodel

文本形状 (Text shape)

在 PPT 中，我们有可以容纳文本的形状。我们可以使用XSLFTextShape类来管理这些形状。下面列出了一些此类别的重要方法。

类 − XSLFTextShape

包 - org.apache.poi.xslf.usermodel

超链接 (HyperLink)

POI 库有一个名为XSLFHyperlink的类，您可以使用它在演示文稿中创建超链接。下面列出了一些此类别的重要方法。

类 − XSLFHyperlink

包 - org.apache.poi.xslf.usermodel

Apache POI PPT - 演示文稿

通常，我们使用 MS-PowerPoint 创建演示文稿。现在让我们看看如何使用 Java 创建演示文稿。完成本章后，您将能够使用您的 Java 程序创建新的 MS-PowerPoint 演示文稿和打开现有的 PPT。

创建空演示文稿

要创建空演示文稿，您必须实例化org.poi.xslf.usermodel包的XMLSlideShow类−

XMLSlideShow ppt = new XMLSlideShow();

使用FileOutputStream类将更改保存到 PPT 文档−

File file = new File("C://POIPPT//Examples//example1.pptx");
FileOutputStream out = new FileOutputStream(file);
ppt.write(out);

下面是创建空白 MS-PowerPoint 演示文稿的完整程序。

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import org.apache.poi.xslf.usermodel.XMLSlideShow;

public class CreatePresentation {
   public static void main(String args[]) throws IOException {
      //creating a new empty slide show
      XMLSlideShow ppt = new XMLSlideShow();	     
      
      //creating an FileOutputStream object
      File file = new File("example1.pptx");
      FileOutputStream out = new FileOutputStream(file);
      
      //saving the changes to a file
      ppt.write(out);
      System.out.println("Presentation created successfully");
      out.close();
   }
}

将上述 Java 代码保存为CreatePresentation.java，然后从命令提示符编译并执行它，如下所示：

$javac CreatePresentation.java
$java CreatePresentation

如果您的系统环境已配置 POI 库，它将编译并执行以在当前目录中生成一个名为example1.pptx的空白 PPT 文件，并在命令提示符上显示以下输出：

Presentation created successfully

空白 PowerPoint 文档如下所示：

编辑现有演示文稿

要打开现有演示文稿，请实例化XMLSlideShow类并将文件的FileInputStream对象作为参数传递给XMLSlideShow构造函数。

File file = new File("C://POIPPT//Examples//example1.pptx");
FileInputstream inputstream = new FileInputStream(file);
XMLSlideShow ppt = new XMLSlideShow(inputstream);

您可以使用org.poi.xslf.usermodel包中XMLSlideShow类的createSlide()方法向演示文稿添加幻灯片。

XSLFSlide slide1 = ppt.createSlide();

下面是打开并向现有 PPT 添加幻灯片的完整程序：

import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import org.apache.poi.xslf.usermodel.XMLSlideShow;
import org.apache.poi.xslf.usermodel.XSLFSlide;

public class EditPresentation {
   public static void main(String ar[]) throws IOException {
      //opening an existing slide show
      File file = new File("example1.pptx");
      FileInputStream inputstream = new FileInputStream(file);
      XMLSlideShow ppt = new XMLSlideShow(inputstream);
      
      //adding slides to the slideshow
      XSLFSlide slide1 = ppt.createSlide();
      XSLFSlide slide2 = ppt.createSlide();
      
      //saving the changes 
      FileOutputStream out = new FileOutputStream(file);
      ppt.write(out);
      
      System.out.println("Presentation edited successfully");
      out.close();	
   }
}

将上述 Java 代码保存为EditPresentation.java，然后从命令提示符编译并执行它，如下所示：

$javac EditPresentation.java
$java EditPresentation

它将编译并执行以生成以下输出：

slides successfully added

带有新添加幻灯片的输出 PPT 文档如下所示：

向 PPT 添加幻灯片后，您可以对幻灯片执行添加、执行、读取和写入操作。

Apache POI PPT - 幻灯片布局

在上一章中，您已经了解了如何创建空幻灯片以及如何向其中添加幻灯片。在本章中，您将学习如何获取可用幻灯片的列表，以及如何创建具有不同布局的幻灯片。

可用的幻灯片布局

PowerPoint 演示文稿具有幻灯片布局，您可以选择所需的布局来编辑幻灯片。首先，让我们找出所有可用的幻灯片布局列表。

• 有不同的母版，每个母版中都有几个幻灯片布局。

• 您可以使用XMLSlideShow类的getSlideMasters()方法获取母版的列表。

• 您可以使用XSLFSlideMaster类的getSlideLayouts()方法从每个母版获取幻灯片布局的列表。

• 您可以使用XSLFSlideLayout类的getType()方法从布局对象获取幻灯片布局的名称。

注意 − 所有这些类都属于org.poi.xslf.usermodel包。

下面是获取 PPT 中可用幻灯片布局列表的完整程序：

import java.io.IOException;
import org.apache.poi.xslf.usermodel.XMLSlideShow;
import org.apache.poi.xslf.usermodel.XSLFSlideLayout;
import org.apache.poi.xslf.usermodel.XSLFSlideMaster;

public class SlideLayouts {
   public static void main(String args[]) throws IOException {
      //create an empty presentation
      XMLSlideShow ppt = new XMLSlideShow();
      System.out.println("Available slide layouts:");
   
      //getting the list of all slide masters
      for(XSLFSlideMaster master : ppt.getSlideMasters()) {
         //getting the list of the layouts in each slide master
         for(XSLFSlideLayout layout : master.getSlideLayouts()) {
            //getting the list of available slides
            System.out.println(layout.getType());
         }
      }
   }
}

将上述 Java 代码保存为SlideLayouts.java，然后从命令提示符编译并执行它，如下所示：

$javac SlideLayouts.java
$java SlideLayouts

它将编译并执行以生成以下输出：

Available slide layouts:
TITLE
PIC_TX
VERT_TX
TWO_TX_TWO_OBJ
BLANK
VERT_TITLE_AND_TX
TITLE_AND_CONTENT
TITLE_ONLY
SECTION_HEADER
TWO_OBJ
OBJ_TX

下面显示的是 MS-Office 360，2013 版中提供的一些示例幻灯片布局。

标题布局

让我们使用标题布局在 PPT 中创建一个幻灯片。请按照以下步骤操作：

步骤 1 − 通过实例化XMLSlideShow类来创建一个空演示文稿，如下所示。

XMLSlideShow ppt = new XMLSlideShow();

步骤 2 − 使用getSlideMasters()方法获取母版的列表。然后，使用索引选择所需的母版，如下所示。

XSLFSlideMaster slideMaster = ppt.getSlideMasters()[0];

在这里，我们获取默认母版，它位于母版数组的第 0 个位置。

步骤 3 − 使用XSLFSlideMaster类的getLayout()方法获取所需的布局。此方法接受一个参数，您必须在此参数中传递SlideLayout类的静态变量之一，该变量表示我们所需的布局。此类中有多个变量，每个变量都表示一个幻灯片布局。

下面的代码片段显示了如何创建标题布局：

XSLFSlideLayout titleLayout = slideMaster.getLayout(SlideLayout.TITLE);

步骤 4 − 通过将幻灯片布局对象作为参数传递来创建一个新的幻灯片。

XSLFSlide slide = ppt.createSlide(titleLayout);

步骤 5 − 使用XSLFSlide类的getPlaceholder()方法选择占位符。此方法接受一个整数参数。通过向其传递0，您将获得XSLFTextShape对象，您可以使用它来访问幻灯片的标题文本区域。使用setText()方法设置标题，如下所示。

XSLFTextShape title1 = slide.getPlaceholder(0);
//setting the title init
title1.setText("Tutorials point");

下面是在演示文稿中创建具有标题布局的幻灯片的完整程序：

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import org.apache.poi.xslf.usermodel.SlideLayout;
import org.apache.poi.xslf.usermodel.XMLSlideShow;
import org.apache.poi.xslf.usermodel.XSLFSlide;
import org.apache.poi.xslf.usermodel.XSLFSlideLayout;
import org.apache.poi.xslf.usermodel.XSLFSlideMaster;
import org.apache.poi.xslf.usermodel.XSLFTextShape;

public class TitleLayout {
   public static void main(String args[]) throws IOException {
      //creating presentation
      XMLSlideShow ppt = new XMLSlideShow();	    	
      
      //getting the slide master object
      XSLFSlideMaster slideMaster = ppt.getSlideMasters().get(0);
      
      //get the desired slide layout 
      XSLFSlideLayout titleLayout = slideMaster.getLayout(SlideLayout.TITLE);
                                                     
      //creating a slide with title layout
      XSLFSlide slide1 = ppt.createSlide(titleLayout);
      
      //selecting the place holder in it 
      XSLFTextShape title1 = slide1.getPlaceholder(0); 
      
      //setting the title init 
      title1.setText("Tutorials point");
      
      //create a file object
      File file = new File("F://Titlelayout.pptx");
      FileOutputStream out = new FileOutputStream(file);
      
      //save the changes in a PPt document
      ppt.write(out);
      System.out.println("slide cretated successfully");
      out.close();  
   }
}

将上述 Java 代码保存为 TitleLayout.java，然后从命令提示符编译并执行它，如下所示：

$javac TitleLayout.java
$java TitleLayout

它将编译并执行以生成以下输出。

slide created successfully

带有新添加标题布局幻灯片的 PPT 文档如下所示：

标题和内容布局

让我们使用标题和内容布局在 PPT 中创建一个幻灯片。请按照以下步骤操作。

步骤 1 − 通过实例化XMLSlideShow类来创建一个空演示文稿，如下所示。

XMLSlideShow ppt = new XMLSlideShow();

步骤 2 − 使用getSlideMasters()方法获取母版的列表。使用索引选择所需的母版，如下所示。

XSLFSlideMaster slideMaster = ppt.getSlideMasters()[0];

在这里，我们获取默认母版，它位于母版数组的第 0 个位置。

步骤 3 − 使用XSLFSlideMaster类的getLayout()方法获取所需的布局。此方法接受一个参数，您必须在此参数中传递SlideLayout类的静态变量之一，该变量表示我们所需的布局。此类中有多个变量表示幻灯片布局。

下面的代码片段显示了如何创建标题和内容布局：

XSLFSlideLayout contentlayout = slideMaster.getLayout(SlideLayout.TITLE_AND_CONTENT);

步骤 4 − 通过将幻灯片布局对象作为参数传递来创建一个新的幻灯片。

XSLFSlide slide = ppt.createSlide(SlideLayout.TITLE_AND_CONTENT);

步骤 5 − 使用XSLFSlide类的getPlaceholder()方法选择占位符。此方法接受一个整数参数。通过向其传递1，您将获得XSLFTextShape对象，您可以使用它来访问幻灯片的内容区域。使用setText()方法设置标题，如下所示。

XSLFTextShape title1 = slide1.getPlaceholder(1);
//setting the title init 
title1.setText("Introduction");

步骤 6 − 使用XSLFTextShape类的clearText()方法清除幻灯片中现有的文本。

body.clearText();

步骤 7 − 使用addNewTextParagraph()方法添加新的段落。现在使用addNewTextRun()方法向段落添加新的文本运行。现在，使用setText()方法向文本运行添加文本，如下所示。

body.addNewTextParagraph().addNewTextRun().setText("this is  my first slide body");

下面是在演示文稿中创建具有标题布局的幻灯片的完整程序：

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import org.apache.poi.xslf.usermodel.SlideLayout;
import org.apache.poi.xslf.usermodel.XMLSlideShow;
import org.apache.poi.xslf.usermodel.XSLFSlide;
import org.apache.poi.xslf.usermodel.XSLFSlideLayout;
import org.apache.poi.xslf.usermodel.XSLFSlideMaster;
import org.apache.poi.xslf.usermodel.XSLFTextShape;

public class TitleAndBodyLayout {
   public static void main(String args[]) throws IOException {
      //creating presentation
      XMLSlideShow ppt = new XMLSlideShow();
      
      //getting the slide master object
      XSLFSlideMaster slideMaster = ppt.getSlideMasters().get(0);
      
      //select a layout from specified list
      XSLFSlideLayout slidelayout = slideMaster.getLayout(SlideLayout.TITLE_AND_CONTENT);
      
      //creating a slide with title and content layout
      XSLFSlide slide = ppt.createSlide(slidelayout);
      
      //selection of title place holder
      XSLFTextShape title = slide.getPlaceholder(0);
      
      //setting the title in it
      title.setText("introduction");
      
      //selection of body placeholder
      XSLFTextShape body = slide.getPlaceholder(1);
      
      //clear the existing text in the slide
      body.clearText();
      
      //adding new paragraph
      body.addNewTextParagraph().addNewTextRun().setText("this is  my first slide body");
      
      //create a file object
      File file = new File("contentlayout.pptx");
      FileOutputStream out = new FileOutputStream(file);
      
      //save the changes in a file
      ppt.write(out);
      System.out.println("slide cretated successfully");
      out.close();                
   }
}

将上述 Java 代码保存为TitleLayout.java，然后从命令提示符编译并执行它，如下所示：

$javac TitleLayout.java
$java TitleLayout

它将编译并执行以生成以下输出：

slide created successfully

带有新添加标题布局幻灯片的 PPT 文档如下所示：

同样，您也可以创建具有不同布局的幻灯片。

Apache POI PPT - 幻灯片管理

完成本章后，您将能够删除、重新排序以及对幻灯片执行读取和写入操作。

更改幻灯片

我们可以使用XMLSlideShow类的setPageSize()方法更改幻灯片的页面大小。

首先创建如下所示的演示文稿：

File file = new File("C://POIPPT//Examples// TitleAndContentLayout.pptx");

//create presentation
XMLSlideShow ppt = new XMLSlideShow(new FileInputStream(file));

使用XMLSlideShow类的getPageSize()方法获取当前幻灯片的大小。

java.awt.Dimension pgsize = ppt.getPageSize();

使用setPageSize()方法设置页面的大小。

ppt.setPageSize(new java.awt.Dimension(1024, 768));

更改幻灯片大小的完整程序如下所示：

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import org.apache.poi.xslf.usermodel.XMLSlideShow;

public class ChangingSlide {
   public static void main(String args[]) throws IOException {
      //create file object
      File file = new File("TitleAndContentLayout.pptx");
	 
      //create presentation
      XMLSlideShow ppt = new XMLSlideShow();
      
      //getting the current page size
      java.awt.Dimension pgsize = ppt.getPageSize();
      int pgw = pgsize.width; //slide width in points
      int pgh = pgsize.height; //slide height in points
      
      System.out.println("current page size of the PPT is:");
      System.out.println("width :" + pgw);
      System.out.println("height :" + pgh);
      
      //set new page size
      ppt.setPageSize(new java.awt.Dimension(2048,1536));
      
      //creating file object
      FileOutputStream out = new FileOutputStream(file);
      
      //saving the changes to a file
      ppt.write(out);
      System.out.println("slide size changed to given dimentions ");
      out.close();	
   }
}

将上述 Java 代码保存为ChangingSlide.java，然后从命令提示符编译并执行它，如下所示：

$javac ChangingSlide.java
$java ChangingSlide

它将编译并执行以生成以下输出。

current page size of the presentation is : 
width :720
height :540
slide size changed to given dimensions

以下是更改幻灯片大小之前的演示文稿快照：

更改大小后，幻灯片如下所示：

重新排序幻灯片

您可以使用setSlideOrder()方法设置幻灯片的顺序。下面是设置幻灯片顺序的过程。

打开现有 PPT 文档，如下所示：

File file = new File("C://POIPPT//Examples//example1.pptx");
XMLSlideShow ppt = new XMLSlideShow(new FileInputStream(file));

使用getSlides()方法获取幻灯片，如下所示：

List<XSLFSlide> slides = ppt.getSlides();

从幻灯片数组中选择一个幻灯片，并使用setSlideOrder()方法更改顺序，如下所示：

//selecting the fourth slide
XSLFSlide selectesdslide = slides.get(4);

//bringing it to the top
ppt.setSlideOrder(selectesdslide, 1);

下面是重新排序演示文稿中幻灯片的完整程序：

import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.List;
import org.apache.poi.xslf.usermodel.XMLSlideShow;
import org.apache.poi.xslf.usermodel.XSLFSlide;

public class ReorderSlide {	
   public static void main(String args[]) throws IOException {
      //opening an existing presentation
      File file = new File("example1.pptx");
      XMLSlideShow ppt = new XMLSlideShow(new FileInputStream(file));
      
      //get the slides 
      List<XSLFSlide> slides = ppt.getSlides();    
      
      //selecting the fourth slide
      XSLFSlide selectesdslide = slides.get(13);
      
      //bringing it to the top
      ppt.setSlideOrder(selectesdslide, 0);
      
      //creating an file object 
      FileOutputStream out = new FileOutputStream(file);
	  
      //saving the changes to a file
      ppt.write(out);
      out.close();	
   }
}

将上述 Java 代码保存为ReorderSlide.java，然后从命令提示符编译并执行它，如下所示：

$javac ReorderSlide.java
$java ReorderSlide

它将编译并执行以生成以下输出。

Reordering of the slides is done

以下是重新排序幻灯片之前的演示文稿快照：

重新排序幻灯片后，演示文稿如下所示。这里我们选择了包含图像的幻灯片并将其移动到顶部。

删除幻灯片

您可以使用removeSlide()方法删除幻灯片。请按照以下步骤删除幻灯片。

使用如下所示的XMLSlideShow类打开现有演示文稿：

File file = new File("C://POIPPT//Examples//image.pptx");
XMLSlideShow ppt = new XMLSlideShow(new FileInputStream(file));

使用removeSlide()方法删除所需的幻灯片。此方法接受一个整型参数。将要删除的幻灯片的索引传递给此方法。

ppt.removeSlide(1);

以下是从演示文稿中删除幻灯片的程序：

import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;

import org.apache.poi.xslf.usermodel.XMLSlideShow;

public class Deleteslide { 
   public static void main(String args[]) throws IOException {
      //Opening an existing slide
      File file = new File("image.pptx");
      XMLSlideShow ppt = new XMLSlideShow(new FileInputStream(file));
      
      //deleting a slide
      ppt.removeSlide(1);
      
      //creating a file object
      FileOutputStream out = new FileOutputStream(file);
      
      //Saving the changes to the presentation
      ppt.write(out);
      out.close();	
   }
}

将上述Java代码保存为Deleteslide.java，然后从命令提示符编译并执行它，如下所示：

$javac Deleteslide.java
$java Deleteslide

它将编译并执行以生成以下输出：

reordering of the slides is done

以下是删除幻灯片之前的演示文稿快照：

删除幻灯片后，演示文稿如下所示：

Apache POI PPT - 图片

在本节中，您将学习如何向PPT添加图像以及如何从中读取图像。

添加图像

您可以使用XSLFSlide的createPicture()方法向演示文稿添加图像。此方法接受字节数组格式的图像。因此，您必须创建要添加到演示文稿的图像的字节数组。

请按照以下步骤向演示文稿添加图像。使用XMLSlideShow创建空幻灯片放映，如下所示：

XMLSlideShow ppt = new XMLSlideShow();

使用createSlide()在其中创建一个空演示文稿。

XSLFSlide slide = ppt.createSlide();

读取要添加的图像文件，并使用IOUtils类的IOUtils.toByteArray()将其转换为字节数组，如下所示：

//reading an image
File image = new File("C://POIPPT//boy.jpg");

//converting it into a byte array
byte[] picture = IOUtils.toByteArray(new FileInputStream(image));

使用addPicture()将图像添加到演示文稿。此方法接受两个变量：要添加的图像的字节数组格式和表示图像文件格式的静态变量。addPicture()方法的用法如下所示：

XSLFPictureData idx = ppt.addPicture(picture, XSLFPictureData.PICTURE_TYPE_PNG);

使用createPicture()将图像嵌入到幻灯片中，如下所示：

XSLFPictureShape pic = slide.createPicture(idx);

以下是向演示文稿中的幻灯片添加图像的完整程序：

import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;

import org.apache.poi.sl.usermodel.PictureData.PictureType;
import org.apache.poi.util.IOUtils;
import org.apache.poi.xslf.usermodel.XMLSlideShow;
import org.apache.poi.xslf.usermodel.XSLFPictureData;
import org.apache.poi.xslf.usermodel.XSLFPictureShape;
import org.apache.poi.xslf.usermodel.XSLFSlide;

public class AddingImage {
   public static void main(String args[]) throws IOException {
      //creating a presentation 
      XMLSlideShow ppt = new XMLSlideShow();
      
      //creating a slide in it 
      XSLFSlide slide = ppt.createSlide();
      
      //reading an image
      File image = new File("C://POIPPT//boy.jpg");
      
      //converting it into a byte array
      byte[] picture = IOUtils.toByteArray(new FileInputStream(image));
      
      //adding the image to the presentation
      XSLFPictureData idx = ppt.addPicture(picture, PictureType.PNG);
      
      //creating a slide with given picture on it
      XSLFPictureShape pic = slide.createPicture(idx);
      
      //creating a file object 
      File file = new File("addingimage.pptx");
      FileOutputStream out = new FileOutputStream(file);
      
      //saving the changes to a file
      ppt.write(out);
      System.out.println("image added successfully");
      out.close();	
   }
}

将上述Java代码保存为AddingImage.java，然后从命令提示符编译并执行它，如下所示：

$javac AddingImage.java
$java AddingImage

它将编译并执行以生成以下输出：

reordering of the slides is done

包含新添加的图像幻灯片的演示文稿如下所示：

读取图像

您可以使用XMLSlideShow类的getPictureData()方法获取所有图片的数据。以下程序从演示文稿中读取图像：

import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;

import org.apache.poi.sl.usermodel.PictureData.PictureType;
import org.apache.poi.xslf.usermodel.XMLSlideShow;
import org.apache.poi.xslf.usermodel.XSLFPictureData;

public class Readingimage {
   public static void main(String args[]) throws IOException {
      //open an existing presentation 
      File file = new File("addingimage.pptx");
      XMLSlideShow ppt = new XMLSlideShow(new FileInputStream(file));
      
      //reading all the pictures in the presentation
      for(XSLFPictureData data : ppt.getPictureData()){
         byte[] bytes = data.getData();
         String fileName = data.getFileName();
         PictureType pictureFormat = data.getType();
         System.out.println("picture name: " + fileName);
         System.out.println("picture format: " + pictureFormat);   
      }	    
      //saving the changes to a file
      FileOutputStream out = new FileOutputStream(file);
      ppt.write(out);
      out.close();	
   }
}

将上述Java代码保存为Readingimage.java，然后从命令提示符编译并执行它，如下所示：

$javac Readingimage.java
$java Readingimage

它将编译并执行以生成以下输出：

picture name: image1.png
picture format: 6 

Apache POI PPT - 创建超链接

在本节中，您将学习如何在演示文稿中创建超链接。

创建超链接

您可以使用XSLFTextRun类的createHyperlink()方法读取演示文稿中的超链接。请按照以下步骤在演示文稿中创建超链接。

使用XMLSlideShow类创建一个空演示文稿，如下所示：

XMLSlideShow ppt = new XMLSlideShow();

创建一个空幻灯片，并使用主体和内容布局创建幻灯片的主体和文本框。

//create an empty presentation
XSLFSlideMaster slideMaster = ppt.getSlideMasters()[0];

//creating a slide with title and content layout
XSLFSlideLayout slidelayout = slideMaster.getLayout(SlideLayout.TITLE_AND_CONTENT);
XSLFSlide slide = ppt.createSlide(slidelayout);

//selection of body place holder
XSLFTextShape body = slide.getPlaceholder(1);

//clear the existing text in the slide
body.clearText();

创建一个文本运行对象并为其设置文本，如下所示：

XSLFTextRun textRun = body.addNewTextParagraph().addNewTextRun();
textRun.setText("Tutorials point");

使用XSLFTextRun类的createHyperlink()方法创建一个超链接，如下所示：

XSLFHyperlink link = textRun.createHyperlink();

使用XSLFHyperlink类的setAddress()方法将链接地址设置为超链接，如下所示：

link.setAddress("https://tutorialspoint.com/");

以下是创建演示文稿中超链接的完整程序：

import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;

import org.apache.poi.xslf.usermodel.SlideLayout;
import org.apache.poi.xslf.usermodel.XMLSlideShow;
import org.apache.poi.xslf.usermodel.XSLFHyperlink;
import org.apache.poi.xslf.usermodel.XSLFSlide;
import org.apache.poi.xslf.usermodel.XSLFSlideLayout;
import org.apache.poi.xslf.usermodel.XSLFSlideMaster;
import org.apache.poi.xslf.usermodel.XSLFTextRun;
import org.apache.poi.xslf.usermodel.XSLFTextShape;

public class CreatingHyperlinks {
   public static void main(String args[]) throws IOException {
      //create an empty presentation
      XMLSlideShow ppt = new XMLSlideShow();
      
      //getting the slide master object
      XSLFSlideMaster slideMaster = ppt.getSlideMasters().get(0);
      
      //select a layout from specified list
      XSLFSlideLayout slidelayout = slideMaster.getLayout(SlideLayout.TITLE_AND_CONTENT);
     
      //creating a slide with title and content layout
      XSLFSlide slide = ppt.createSlide(slidelayout);
      
      //selection of title place holder
      XSLFTextShape body = slide.getPlaceholder(1);
      
      //clear the existing text in the slid
      body.clearText();
      
      //adding new paragraph
      XSLFTextRun textRun = body.addNewTextParagraph().addNewTextRun();
      
      //setting the text
      textRun.setText("Tutorials point");	
      
      //creating the hyperlink
      XSLFHyperlink link = textRun.createHyperlink();
      
      //setting the link address
      link.setAddress("https://tutorialspoint.com/");
      
      //create the file object            
      File file = new File("hyperlink.pptx");
      FileOutputStream out = new FileOutputStream(file);
      
      //save the changes in a file
      ppt.write(out);
      System.out.println("slide created successfully");
      out.close();              
   }
}

将上述Java代码保存为CreatingHyperlinks.java，然后从命令提示符编译并执行它，如下所示：

$javac CreatingHyperlinks.java
$java CreatingHyperlinks

它将编译并执行以生成以下输出：

slide created successfully 

在其主体中包含超链接的新添加的幻灯片如下所示：

Apache POI PPT - 读取形状

您可以使用XSLFShape类的getShapeName()方法获取演示文稿中使用的形状数量。以下是从演示文稿中读取形状的程序：

import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.List;
import org.apache.poi.xslf.usermodel.XMLSlideShow;
import org.apache.poi.xslf.usermodel.XSLFShape;
import org.apache.poi.xslf.usermodel.XSLFSlide;

public class ReadingShapes {
   public static void main(String args[]) throws IOException {
      //creating a slideshow 
      File file = new File("shapes.pptx");
      XMLSlideShow ppt = new XMLSlideShow(new FileInputStream(file));
      
      //get slides 
      List<XSLFSlide> slide = ppt.getSlides();
      
      //getting the shapes in the presentation
      System.out.println("Shapes in the presentation:");
      for (int i = 0; i < slide.size(); i++){
         List<XSLFShape> sh = slide.get(i).getShapes();
         for (int j = 0; j < sh.size(); j++){
            //name of the shape
            System.out.println(sh.get(j).getShapeName());
         }
      }
      FileOutputStream out = new FileOutputStream(file);
      ppt.write(out);
      out.close();	
   }
}

将上述Java代码保存为ReadingShapes.java，然后从命令提示符编译并执行它，如下所示：

$javac ReadingShapes.java
$java ReadingShapes

它将编译并执行以生成以下输出。

Shapes in the presentation: 
Rectangle 1
Oval 1
Isosceles Triangle 1

包含各种形状的新添加的幻灯片如下所示：

Apache POI PPT - 文本格式化

演示文稿中的文本可以使用XSLFTextRun类的方法进行格式化。为此，您必须通过选择其中一个幻灯片布局来创建一个XSLFTextRun类对象，如下所示：

//create the empty presentation 
XMLSlideShow ppt = new XMLSlideShow();

//getting the slide master object
XSLFSlideMaster slideMaster = ppt.getSlideMasters().get(0);

//select a layout from specified list
XSLFSlideLayout slidelayout = slideMaster.getLayout(SlideLayout.TITLE_AND_CONTENT);

//creating a slide with title and content layout
XSLFSlide slide = ppt.createSlide(slidelayout);

//selection of title place holder
XSLFTextShape body = slide.getPlaceholder(1);

//clear the existing text in the slide
body.clearText();

//adding new paragraph
XSLFTextParagraph paragraph = body.addNewTextParagraph();

//creating text run object
XSLFTextRun run = paragraph.addNewTextRun();

您可以使用setFontSize()设置演示文稿中文本的字体大小。

run.setFontColor(java.awt.Color.red);
run.setFontSize(24);

以下代码片段显示了如何将不同的格式样式（粗体、斜体、下划线、删除线）应用于演示文稿中的文本。

//change the text into bold format
run.setBold(true);

//change the text it to italic format
run.setItalic(true)

// strike through the text
run.setStrikethrough(true);

//underline the text
run.setUnderlined(true);

要在段落之间换行，请使用XSLFTextParagraph类的addLineBreak()，如下所示：

paragraph.addLineBreak();

以下是使用上述所有方法格式化文本的完整程序：

import java.io.FileOutputStream;
import java.io.IOException;

import org.apache.poi.xslf.usermodel.SlideLayout;
import org.apache.poi.xslf.usermodel.XMLSlideShow;
import org.apache.poi.xslf.usermodel.XSLFSlide;
import org.apache.poi.xslf.usermodel.XSLFSlideLayout;
import org.apache.poi.xslf.usermodel.XSLFSlideMaster;
import org.apache.poi.xslf.usermodel.XSLFTextParagraph;
import org.apache.poi.xslf.usermodel.XSLFTextRun;
import org.apache.poi.xslf.usermodel.XSLFTextShape;

public class TextFormating {
   public static void main(String args[]) throws IOException {
      //creating an empty presentation
      XMLSlideShow ppt = new XMLSlideShow();
      
      //getting the slide master object
      XSLFSlideMaster slideMaster = ppt.getSlideMasters().get(0);
      
      //select a layout from specified list
      XSLFSlideLayout slidelayout = slideMaster.getLayout(SlideLayout.TITLE_AND_CONTENT);
      
      //creating a slide with title and content layout
      XSLFSlide slide = ppt.createSlide(slidelayout);
      
      //selection of title place holder
      XSLFTextShape body = slide.getPlaceholder(1);
      
      //clear the existing text in the slide
      body.clearText();
      
      //adding new paragraph
      XSLFTextParagraph paragraph = body.addNewTextParagraph();
      
      //formatting line 1
      
      XSLFTextRun run1 = paragraph.addNewTextRun();
      run1.setText("This is a colored line");      
      
      //setting color to the text
      run1.setFontColor(java.awt.Color.red);      
      
      //setting font size to the text
      run1.setFontSize(24.0);      
      
      //moving to the next line
      paragraph.addLineBreak();
     
      //formatting line 2
      
      XSLFTextRun run2 = paragraph.addNewTextRun();
      run2.setText("This is a bold line");
      run2.setFontColor(java.awt.Color.CYAN);
      
      //making the text bold
      run2.setBold(true);
      paragraph.addLineBreak();
      
      //formatting line 3
      
      XSLFTextRun run3 = paragraph.addNewTextRun();
      run3.setText(" This is a striked line");
      run3.setFontSize(12.0);
      
      //making the text italic
      run3.setItalic(true);
      
      //strike through the text
      run3.setStrikethrough(true);
      paragraph.addLineBreak();
       
      //formatting line 4
      
      XSLFTextRun run4 = paragraph.addNewTextRun();
      run4.setText(" This an underlined line");
      run4.setUnderlined(true);
      
      //underlining the text
      paragraph.addLineBreak();
      
      //creating a file object
      File file = new File(“TextFormat.pptx”);
      FileOutputStream out = new FileOutputStream(file);
       
      //saving the changes to a file
      ppt.write(out);
      out.close();	 
   }
}

将上述代码保存为TextFormating.java，然后从命令提示符编译并执行它，如下所示：

$javac TextFormating.java
$java TextFormating

它将编译并执行以生成以下输出：

Formatting completed successfully 

包含格式化文本的幻灯片如下所示：

Apache POI PPT - 合并

您可以使用XMLSlideShow类的importContent()方法合并多个演示文稿。以下是合并两个演示文稿的完整程序：

import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;

import org.apache.poi.xslf.usermodel.XMLSlideShow;
import org.apache.poi.xslf.usermodel.XSLFSlide;

public class MergingMultiplePresentations {
   
      public static void main(String args[]) throws IOException {
      
      //creating empty presentation
      XMLSlideShow ppt = new XMLSlideShow();
      
      //taking the two presentations that are to be merged 
      String file1 = "presentation1.pptx";
      String file2 = "presentation2.pptx";
      String[] inputs = {file1, file2};
      
      for(String arg : inputs){
      
         FileInputStream inputstream = new FileInputStream(arg);
         XMLSlideShow src = new XMLSlideShow(inputstream);
         
         for(XSLFSlide srcSlide : src.getSlides()) {
         
            //merging the contents
            ppt.createSlide().importContent(srcSlide);
         }
      }
     
      String file3 = "combinedpresentation.pptx";
      
      //creating the file object
      FileOutputStream out = new FileOutputStream(file3);
      
      // saving the changes to a file
      ppt.write(out);
      System.out.println("Merging done successfully");
      out.close();
   }
}

将上述代码保存为MergingMultiplePresentations.java，然后从命令提示符编译并执行它，如下所示：

$javac MergingMultiplePresentations.java
$java MergingMultiplePresentations

它将编译并执行以生成以下输出：

Merging done successfully

以下快照显示第一个演示文稿：

以下快照显示第二个演示文稿：

以下是合并两个幻灯片后程序的输出。在这里您可以看到先前幻灯片的内容合并在一起。

Apache POI PPT - PPT 转图片

您可以将演示文稿转换为图像文件。以下程序显示了如何操作。

import java.awt.Color;
import java.awt.Dimension;
import java.awt.Graphics2D;
import java.awt.geom.Rectangle2D;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.FileInputStream;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.List;
import org.apache.poi.xslf.usermodel.XMLSlideShow;
import org.apache.poi.xslf.usermodel.XSLFSlide;

public class PptToImage {
   public static void main(String args[]) throws IOException {
      //creating an empty presentation
      File file=new File("pptToImage.pptx");
      XMLSlideShow ppt = new XMLSlideShow(new FileInputStream(file));
      
      //getting the dimensions and size of the slide 
      Dimension pgsize = ppt.getPageSize();
      List<XSLFSlide> slide = ppt.getSlides();
      BufferedImage img = null;
      for (int i = 0; i < slide.size(); i++) {
         img = new BufferedImage(pgsize.width, pgsize.height,BufferedImage.TYPE_INT_RGB);
         Graphics2D graphics = img.createGraphics();

         //clear the drawing area
         graphics.setPaint(Color.white);
         graphics.fill(new Rectangle2D.Float(0, 0, pgsize.width, pgsize.height));

         //render
         slide.get(i).draw(graphics);
      }
      //creating an image file as output
      FileOutputStream out = new FileOutputStream("ppt_image.png");
      javax.imageio.ImageIO.write(img, "png", out);
      ppt.write(out);
      
      System.out.println("Image successfully created");
      out.close();	
   }
}

将上述Java代码保存为PpttoPNG.java，然后从命令提示符编译并执行它，如下所示：

$javac PpttoPNG.java
$java PpttoPNG

它将编译并执行以生成以下输出：

Image created successfully

以下快照显示作为输入的演示文稿：

以下是指定位置创建的图像的快照。