iText - 设置图像的位置

在本章中,我们将了解如何使用 iText 库设置 PDF 文档中图像的位置。

设置图像的位置

您可以通过实例化 Document 类来创建一个空的 PDF 文档。在实例化此类时,您需要将 PdfDocument 对象作为参数传递给其构造函数。

要将图像添加到 pdf,请创建需要添加的图像的对象,然后使用 Document 类的 add() 方法添加它。您可以使用 Image 类的方法 setFixedPosition() 将图像插入文档中的所需位置。

以下是设置 PDF 文档中图像位置的步骤。

步骤 1:创建 PdfWriter 对象

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

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

// 创建 PdfWriter
String dest = "C:/itextExamples/positionOfImage.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.layoutDocument 类是创建自给自足 PDF 时的根元素。此类的构造函数之一接受 PdfDocument 类的对象。

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

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

步骤 4:创建 Image 对象

要创建图像对象,首先,使用 ImageDataFactory 类的 create() 方法创建一个 ImageData 对象。作为此方法的参数,传递一个表示图像路径的字符串参数,如下所示。

// 创建 ImageData 对象
String imageFile = "C:/itextExamples/javafxLogo.jpg";
ImageData data = ImageDataFactory.create(imageFile);

现在,实例化 com.itextpdf.layout.element 包的 Image 类。实例化时,将 ImageData 对象作为参数传递给其构造函数,如下所示。

// 创建 Image 对象
Image img = new Image(data);

步骤 5:设置图像的位置

您可以使用 Image 的 setFixedPosition() 方法设置图像在 PDF 文档中的位置。使用此方法将图像的位置设置为文档上的坐标 (100, 250),如下所示。

// 将图像的位置设置为页面的中心
image.setFixedPosition(100, 250);

步骤 6:向文档添加图像

现在,使用 Document 类的 add() 方法添加上一步中创建的图像对象,如下所示。

// 向文档添加图像
document.add(img);

步骤 7:关闭文档

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

// 关闭文档
document.close();

示例

以下 Java 程序演示如何使用 iText 库将图像设置在 PDF 文档上的所需位置。它创建一个名为 positionOfImage.pdf 的 PDF 文档,向其中添加图像,将其设置为更靠近页面中心的位置,并将其保存在路径 C:/itextExamples/

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

import com.itextpdf.io.image.ImageData; 
import com.itextpdf.io.image.ImageDataFactory; 

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

import com.itextpdf.layout.Document; 
import com.itextpdf.layout.element.Image;  

public class SettingPosition {      
   public static void main(String args[]) throws Exception {              
        // 创建 PdfWriter
        String dest = "C:/EXAMPLES/itextExamples/3images/positionOfImage.pdf";
        PdfWriter writer = new PdfWriter(dest);
        
        // 创建 PdfDocument
        PdfDocument pdfDoc = new PdfDocument(writer);
        
        // 创建 Document
        Document document = new Document(pdfDoc);
        
        // 创建 ImageData 对象
        String imFile = "C:/EXAMPLES/itextExamples/3images/logo.jpg";
        ImageData data = ImageDataFactory.create(imFile);
        
        // 创建 Image 对象
        Image image = new Image(data);
        
        // 将图像的位置设置为页面中心
        image.setFixedPosition(100, 250);
        
        // 将图像添加到文档
        document.add(image);
        
        // 关闭文档
        document.close();
      
      	System.out.println("Image added");    
   } 
}

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

javac SettingPosition.java 
java SettingPosition 

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

Image added

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

图像的位置