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 文件，如下所示。

列印頁面