iText - 在表格中添加列表

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

在 PDF 中向表格添加列表

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

要向表格添加 **列表**，您需要实例化 **com.itextpdf.layout.element** 包中的 **List** 类，并使用 **Cell** 类的 **add()** 方法将其插入到 **单元格** 对象中。

以下是向表格的单元格添加列表的步骤。

步骤 1：创建 PdfWriter 对象

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

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

// Creating a PdfWriter 
String dest = "C:/itextExamples/addingObjects.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：创建 Table 对象

**Table** 类表示一个二维网格，其中填充了单元格，并按行和列排序。它属于 **com.itextpdf.layout.element** 包。

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

// Creating a table 
float [] pointColumnWidths = {200F, 200F}; 
Table table = new Table(pointColumnWidths);

步骤 5：创建单元格

通过实例化 **com.itextpdf.layout** 包中的 **Cell** 类来创建 **单元格** 对象，如下所示。

// Adding cell to the table 
Cell listCell = new Cell(); // Creating a cell

步骤 6：创建 List 对象

创建单元格后，通过实例化 **com.itextpdf.layout.element** 包中的 **List** 类来创建一个 **列表** 对象。通过实例化 **ListItem** 类创建列表项，并使用 **List** 类的 **add()** 方法添加创建的项，如下所示。

List list = new List(); 
ListItem item1 = new ListItem("JavaFX"); 
ListItem item2 = new ListItem("Java"); 
ListItem item3 = new ListItem("Java Servlets");        
list.add(item1); 
list.add(item2); 
list.add(item3);

步骤 7：将列表添加到表格的单元格中

现在，使用 **Cell** 类的 **add()** 方法将上面创建的列表添加到表格的单元格中。然后，使用 **Table** 类的 **addCell()** 方法将此单元格添加到表格中，如下所示。

listCell.add(list); 
table.addCell(listCell);

步骤 8：将表格添加到文档中

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

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

步骤 9：关闭文档

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

// Closing the document 
document.close();

示例

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

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

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

import com.itextpdf.layout.Document; 
import com.itextpdf.layout.element.Cell; 
import com.itextpdf.layout.element.List; 
import com.itextpdf.layout.element.ListItem; 
import com.itextpdf.layout.element.Table; 
import com.itextpdf.layout.property.TextAlignment;  

public class AddingListsToTable {      
   public static void main(String args[]) throws Exception {              
      // Creating a PdfWriter object
      String file = "C:/itextExamples/addingObjects.pdf";       
      PdfDocument pdfDoc = new PdfDocument(new PdfWriter(file));                   
      
      // Creating a Document object       
      Document doc = new Document(pdfDoc);               
      
      // Creating a table       
      float [] pointColumnWidths = {300F, 300F};       
      Table table = new Table(pointColumnWidths);                            
      
      // Adding row 1 to the table                
      Cell c1 = new Cell();       
      c1.add("Java Related Tutorials");       
      c1.setTextAlignment(TextAlignment.LEFT);       
      table.addCell(c1);                      
      
      List list1 = new List();       
      ListItem item1 = new ListItem("JavaFX");
      ListItem item2 = new ListItem("Java");       
      ListItem item3 = new ListItem("Java Servlets");              
      list1.add(item1);       
      list1.add(item2);       
      list1.add(item3);                 
      
      Cell c2 = new Cell();       
      c2.add(list1);       
      c2.setTextAlignment(TextAlignment.LEFT);       
      table.addCell(c2);                 
      
      // Adding row 2 to the table                
      Cell c3 = new Cell();       
      c3.add("No SQL Databases");       
      c3.setTextAlignment(TextAlignment.LEFT);       
      table.addCell(c3);                     
      
      List list2 = new List();       
      list2.add(new ListItem("HBase"));       
      list2.add(new ListItem("Neo4j"));       
      list2.add(new ListItem("MongoDB"));                 
      
      Cell c4 = new Cell();       
      c4.add(list2); 
      c4.setTextAlignment(TextAlignment.LEFT);       
      table.addCell(c4);                       
      
      // Adding Table to document        
      doc.add(table);                  
      
      // Closing the document       
      doc.close();  
      System.out.println("Lists added to table successfully..");     
   } 
}

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

javac AddingListsToTable.java 
java AddingListsToTable

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

Lists added to table successfully..

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

打印页面