iText - 添加列表

在本章中，我们将学习如何使用 iText 库创建 PDF 文档并在其中添加列表。

创建列表

您可以通过实例化 **Document** 类来创建一个空的 PDF 文档。在实例化此类时，您需要将 **PdfDocument** 对象作为参数传递给其构造函数。然后，要向文档添加列表，您需要实例化 **List** 类并将此对象使用 **add()** 方法添加到文档中。

以下是创建 PDF 文档并在其中添加列表的步骤。

步骤 1：创建 PdfWriter 对象

**PdfWriter** 类表示 PDF 的 DocWriter。此类属于 **com.itextpdf.kernel.pdf** 包。此类的构造函数接受一个字符串，表示要创建 PDF 文件的路径。

通过将字符串值（表示您需要创建 PDF 的路径）传递给其构造函数来实例化 PdfWriter 类，如下所示。

// Creating a PdfWriter 
String dest = "C:/itextExamples/addingList.pdf"; 
PdfWriter writer = new PdfWriter(dest);

当此类型的对象传递给 PdfDocument（类）时，添加到此文档的每个元素都将写入指定的文件。

步骤 2：创建 PdfDocument 对象

**PdfDocument** 类是表示 iText 中 PDF 文档的类，此类属于 **com.itextpdf.kernel.pdf** 包。要实例化此类（在写入模式下），您需要将 **PdfWriter** 类的对象传递给其构造函数。

通过将上面创建的 PdfWriter 对象传递给其构造函数来实例化 PdfDocument 类，如下所示。

// Creating a PdfDocument  
PdfDocument pdfDoc = new PdfDocument(writer);

创建 PdfDocument 对象后，您可以使用其类提供的相应方法添加各种元素，例如页面、字体、文件附件和事件处理程序。

步骤 3：创建 Document 对象

**com.itextpdf.layout** 包的 **Document** 类是在创建自包含 PDF 时使用的根元素。此类的构造函数之一接受 **PdfDocument** 类的对象。

通过将上一步骤中创建的 **PdfDocument** 类对象传递给构造函数来实例化 **Document** 类，如下所示。

// Creating a Document   
Document document = new Document(pdfDoc);

步骤 4：创建 List 对象

**List** 类表示一系列垂直排列的对象。它属于 **com.itextpdf.layout.element** 包。

如以下所示实例化 **List** 类。

// Creating a list  
List list = new List();

步骤 5：向列表添加元素

通过将字符串值传递给 **List** 类的 **add()** 方法，向 **list** 对象添加内容，如下所示。

//  Add elements to the list 
list.add("Java"); 
list.add("JavaFX"); 
list.add("Apache Tika"); 
list.add("OpenCV");

步骤 6：将列表添加到文档

使用 **Document** 类的 **add()** 方法添加上一步中创建的 **list** 对象，如下所示。

// Adding list to the document 
document.add(list);

步骤 7：关闭文档

使用 **Document** 类的 **close()** 方法关闭文档，如下所示。

// Closing the document 
document.close();

示例

以下 Java 程序演示了如何使用 iText 库创建 PDF 文档并在其中添加列表。它创建一个名为 **addingList.pdf** 的 PDF 文档，向其中添加一个列表，并将其保存到 **C:/itextExamples/** 路径。

将此代码保存在名为 **AddingList.java** 的文件中。

import com.itextpdf.kernel.pdf.PdfDocument; 
import com.itextpdf.kernel.pdf.PdfWriter; 

import com.itextpdf.layout.Document; 
import com.itextpdf.layout.element.List; 
import com.itextpdf.layout.element.Paragraph;  

public class AddingList {      
   public static void main(String args[]) throws Exception {               
      // Creating a PdfWriter
      String dest = "C:/itextExamples/addngList.pdf";       
      PdfWriter writer = new PdfWriter(dest);              
   
      // Creating a PdfDocument       
      PdfDocument pdf = new PdfDocument(writer);              
   
      // Creating a Document        
      Document document = new Document(pdf);              
   
      // Creating a Paragraph       
      Paragraph paragraph = new Paragraph("Tutorials Point provides the following tutorials");
      
      // Creating a list
      List list = new List();  
      
      // Add elements to the list       
      list.add("Java");       
      list.add("JavaFX");      
      list.add("Apache Tika");       
      list.add("OpenCV");       
      list.add("WebGL");       
      list.add("Coffee Script");       
      list.add("Java RMI");       
      list.add("Apache Pig");              
      
      // Adding paragraph to the document       
      document.add(paragraph);                    
     
      // Adding list to the document       
      document.add(list);
      
      // Closing the document       
      document.close();              
      System.out.println("List added");    
   } 
}

使用以下命令从命令提示符编译并执行保存的 Java 文件：

javac AddingList.java 
java AddingList

执行后，上述程序将创建一个 PDF 文档，显示以下消息。

List added

如果验证指定的路径，您可以找到创建的 PDF 文档，如下所示。

打印页面