iText - 添加列表

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

创建列表

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

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

步骤 1：创建 PdfWriter 对象

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

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

// 创建 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 类，如下所示。

// 创建 PdfDocument
PdfDocument pdfDoc = new PdfDocument(writer);

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

步骤 3：创建 Document 对象

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

通过传递在前面步骤中创建的 PdfDocument 类的对象来实例化 Document 类，如下所示。

// 创建文档
Document document = new Document(pdfDoc);

步骤 4：创建 List 对象

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

实例化 List 类，如下所示。

// 创建列表
List list = new List();

步骤 5：向列表添加元素

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

// 将元素添加到列表
list.add("Java");
list.add("JavaFX");
list.add("Apache Tika");
list.add("OpenCV");

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

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

// 将列表添加到文档
document.add(list);

步骤 7：关闭文档

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

// 关闭文档
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 {               
        // 创建 PdfWriter
        String dest = "C:/itextExamples/addngList.pdf";
        PdfWriter writer = new PdfWriter(dest);
        
        // 创建 PdfDocument
        PdfDocument pdf = new PdfDocument(writer);
        
        // 创建文档
        Document document = new Document(pdf);
        
        // 创建段落
        Paragraph passage = new Paragraph("Tutorials Point 提供以下教程");
        
        // 创建列表
        List list = new 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");
        
        // 向文档添加段落
        document.add(paragraph);
        
        // 向文档添加列表
        document.add(list);
        
        // 关闭文档
        document.close();
        System.out.println("列表已添加");
   } 
} 

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

javac AddingList.java 
java AddingList

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

列表已添加

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