iText - Adicionando Imagem a uma Mesa

Neste capítulo, veremos como adicionar uma imagem a uma tabela em um documento PDF usando a biblioteca iText.

Adicionar uma imagem a uma mesa

Você pode criar um documento PDF vazio instanciando o Documentclasse. Ao instanciar esta classe, você precisa passar por umPdfDocumentobjeto como parâmetro, para seu construtor. Então, para adicionar uma tabela ao documento, você precisa instanciar oTable classe e adicionar este objeto ao documento usando o add() método.

Para adicionar uma imagem a esta tabela, você precisa instanciar o Cell classe, crie e um objeto da imagem que deve ser adicionado, adicione a imagem ao cell objeto usando o add() método do Cell classe.

A seguir estão as etapas para inserir uma imagem na célula de uma tabela.

Etapa 1: Criação de um objeto PdfWriter

o PdfWriter classe representa o Doc Writer para um PDF, esta classe pertence ao pacote com.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 que representa o caminho onde você precisa criar um PDF, para seu construtor, conforme mostrado abaixo.

// Creating a PdfWriter 
String dest = "C:/itextExamples/addingImage.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 o 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 classePdfDocument.

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 Tabela

o Tableclasse representa uma grade bidimensional preenchida com células, ordenadas em linhas e colunas. Pertence ao pacotecom.itextpdf.layout.element.

Instancie o Table classe como mostrado abaixo.

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

Etapa 5: Criação da célula

Criar uma cell objeto instanciando o Cell classe do pacote com.itextpdf.layout, como mostrado abaixo.

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

Etapa 6: Criação de uma imagem

Para criar o image objeto, 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 criado acima, como parâmetro do seu construtor, conforme mostrado a seguir.

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

Adicione o image objeto para a célula usando o add() método da classe de célula, conforme mostrado abaixo.

// Adding image to the cell  
cell.add(img.setAutoScale(true));

Etapa 7: Adicionando célula à tabela

Finalmente, para adicionar esta célula à tabela, chame o addCell() método do Table classe e passar no cell objeto como parâmetro para este método, conforme mostrado a seguir.

table.addCell(cell);

Etapa 8: Adicionando tabela ao documento

Adicione o table objeto criado na etapa anterior usando o add() método do Document classe, conforme mostrado abaixo.

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

Etapa 9: 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 adicionar uma imagem a uma célula de uma tabela em um documento PDF usando a biblioteca iText. Ele cria um documento PDF com o nomeaddingImage.pdf, adiciona uma tabela a ele, insere uma imagem (javafxLogo.jpg) em uma de suas células e a salva no caminho C:/itextExamples/.

Salve este código em um arquivo com o nome AddingImageToTable.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.Cell; 
import com.itextpdf.layout.element.Image; 
import com.itextpdf.layout.element.Table;  

public class a3AddingImageToTable {
   public static void main(String args[]) throws Exception {
      // Creating a PdfWriter object 
      String dest = "C:/itextExamples/addingImage.pdf";
      PdfWriter writer = new PdfWriter(dest);    
      
      // Creating a PdfDocument object   
      PdfDocument pdfDoc = new PdfDocument(writer);
      
      // Creating a Document object
      Document doc = new Document(pdfDoc);
      
      // Creating a table
      float [] pointColumnWidths = {150f, 150f};
      Table table = new Table(pointColumnWidths);
      
      // Populating row 1 and adding it to the table
      Cell cell1 = new Cell();
      cell1.add("Tutorial ID");
      table.addCell(cell1);
      
      Cell cell2 = new Cell();
      cell2.add("1");
      table.addCell(cell2);
      
      // Populating row 2 and adding it to the table
      Cell cell3 = new Cell();
      cell3.add("Tutorial Title");
      table.addCell(cell3);             
      
      Cell cell4 = new Cell(); 
      cell4.add("JavaFX");  
      table.addCell(cell4);
      
      // Populating row 3 and adding it to the table
      Cell cell5 = new Cell();
      cell5.add("Tutorial Author");
      table.addCell(cell5);            
      
      Cell cell6 = new Cell();
      cell6.add("Krishna Kasyap");
      table.addCell(cell6);
      
      // Populating row 4 and adding it to the table
      Cell cell7 = new Cell();
      cell7.add("Submission date");
      table.addCell(cell7);
      
      Cell cell8 = new Cell();
      cell8.add("2016-07-06");
      table.addCell(cell8);              
      
      // Populating row 5 and adding it to the table
      Cell cell9 = new Cell();
      cell9.add("Tutorial Icon");
      table.addCell(cell9);              
      
      // Creating the cell10       
      Cell cell10 = new Cell();              
      
      // Creating an ImageData object       
      String imageFile = "C:/itextExamples/javafxLogo.jpg";       
      ImageData data = ImageDataFactory.create(imageFile);        

      // Creating the image       
      Image img = new Image(data);              

      // Adding image to the cell10       
      cell10.add(img.setAutoScale(true));        

      // Adding cell110 to the table       
      table.addCell(cell10);                         
      
      // Adding Table to document        
      doc.add(table);                  
      
      // Closing the document       
      doc.close();  
      
      System.out.println("Image added to table successfully..");     
   } 
}

Compile e execute o arquivo Java salvo no prompt de comando usando os seguintes comandos -

javac AddingImageToTable.java 
java AddingImageToTable

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

Image added to table successfully..

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