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.layout 的 Document 类是创建自给自足 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文档，如下所示。