iText - Definição da posição da imagem

Neste capítulo, veremos como definir a posição de uma imagem em um documento PDF usando a biblioteca iText.

Definir a posição da imagem

Você pode criar um documento PDF vazio instanciando o Documentclasse. Ao instanciar esta classe, você precisa passar por umPdfDocument objeto como um parâmetro para seu construtor.

Para adicionar uma imagem ao pdf, crie um objeto da imagem que deve ser adicionado e adicione-o usando o add() método do Documentclasse. Você pode inserir a imagem na posição desejada no documento usando o métodosetFixedPosition() do Image classe.

A seguir estão as etapas para definir a posição de uma imagem no documento PDF.

Etapa 1: Criação de um objeto PdfWriter

o PdfWriterclasse representa o DocWriter para um PDF. Esta classe pertence ao pacotecom.itextpdf.kernel.pdf. O construtor desta classe aceita uma string, representando o caminho do arquivo onde o PDF será criado.

Instancie a classe PdfWriter passando um valor de string (representando o caminho onde você precisa criar um PDF) para seu construtor, conforme mostrado abaixo.

// Creating a PdfWriter 
String dest = "C:/itextExamples/positionOfImage.pdf"; 
PdfWriter writer = new PdfWriter(dest);

Quando um objeto desse tipo é passado para um PdfDocument (classe), cada elemento adicionado a este documento será gravado no arquivo especificado.

Etapa 2: Criação de um objeto PdfDocument

o PdfDocumentclass é a classe que representa o documento PDF no iText. Esta classe pertence ao pacotecom.itextpdf.kernel.pdf. Para instanciar esta classe (no modo de escrita), você precisa passar um objeto da classePdfWriter para seu construtor.

Instancie a classe PdfDocument passando o objeto PdfWriter criado acima para seu construtor, conforme mostrado abaixo.

// Creating a PdfDocument  
PdfDocument pdfDoc = new PdfDocument(writer);

Depois que um objeto PdfDocument é criado, você pode adicionar vários elementos como página, fonte, anexo de arquivo e manipulador de eventos usando os respectivos métodos fornecidos por sua classe.

Etapa 3: Criação do objeto Documento

o Document classe do pacote com.itextpdf.layouté o elemento raiz ao criar um PDF autossuficiente. Um dos construtores desta classe aceita um objeto da classe PdfDocument.

Instancie o Document classe passando o objeto da classe PdfDocument criado nas etapas anteriores, conforme mostrado abaixo.

// Creating a Document  
Document document = new Document(pdfDoc);

Etapa 4: Criando um objeto Image

Para criar o objeto de imagem, em primeiro lugar, crie um ImageData objeto usando o create() método do ImageDataFactoryclasse. Como parâmetro deste método, passe um parâmetro string que representa o caminho da imagem, conforme mostrado abaixo.

// Creating an ImageData object 
String imageFile = "C:/itextExamples/javafxLogo.jpg"; 
ImageData data = ImageDataFactory.create(imageFile);

Agora, instancie o Image classe do com.itextpdf.layout.elementpacote. Durante a instanciação, passe oImageData objeto como parâmetro para seu construtor, conforme mostrado a seguir.

// Creating an Image object 
Image img = new Image(data);

Etapa 5: Definir a posição da imagem

Você pode definir a posição da imagem em um documento PDF usando o setFixedPosition()método da imagem. Defina a posição da imagem para as coordenadas (100, 250) no documento usando este método, conforme mostrado abaixo.

// Setting the position of the image to the center of the page 
image.setFixedPosition(100, 250);

Etapa 6: Adicionar imagem ao documento

Agora, adicione o objeto de imagem, criado na etapa anterior, usando o add() método do Document classe, conforme mostrado abaixo.

// Adding image to the document 
document.add(img);

Etapa 7: Fechando o Documento

Feche o documento usando o close() método do Document classe, conforme mostrado abaixo.

// Closing the document 
document.close();

Exemplo

O programa Java a seguir demonstra como definir uma imagem em uma posição desejada em um documento PDF usando a biblioteca iText. Ele cria um documento PDF com o nomepositionOfImage.pdf, adiciona uma imagem a ele, posiciona-o mais próximo do centro da página e salva no caminho C:/itextExamples/

Salve este código em um arquivo com o nome 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 {              
      // Creating a PdfWriter       
      String dest = "C:/EXAMPLES/itextExamples/3images/positionOfImage.pdf";       
      PdfWriter writer = new PdfWriter(dest);               
      
      // Creating a PdfDocument       
      PdfDocument pdfDoc = new PdfDocument(writer);              
      
      // Creating a Document        
      Document document = new Document(pdfDoc);              
      
      // Creating an ImageData object       
      String imFile = "C:/EXAMPLES/itextExamples/3images/logo.jpg";       
      ImageData data = ImageDataFactory.create(imFile);             

      // Creating an Image object        
      Image image = new Image(data);                
      
      // Setting the position of the image to the center of the page       
      image.setFixedPosition(100, 250);                  
      
      // Adding image to the document       
      document.add(image);              
      
      // Closing the document       
      document.close();
      
      System.out.println("Image added");    
   } 
}

Compile e execute o arquivo Java salvo no prompt de comando usando os comandos a seguir.

javac SettingPosition.java 
java SettingPosition

Após a execução, o programa acima cria um documento PDF, exibindo a seguinte mensagem.

Image added

Se você verificar o caminho especificado, poderá encontrar o documento PDF criado conforme mostrado abaixo.