iText - Desenhar uma Linha

Neste capítulo, veremos como desenhar uma linha em um documento PDF usando a biblioteca iText.

Desenhar uma linha em um PDF

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

Para desenhar uma linha em um PdfDocument instancie o PdfCanvas classe do pacote com.itextpdf.kernel.pdf.canvas e criar uma linha usando o moveTo() e lineTO() métodos desta classe.

A seguir estão as etapas para traçar uma linha 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/drawingLine.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: Criação de um objeto PdfCanvas

Crie um novo PdfPage classe usando o addNewPage() método do PdfDocument classe.

Instancie o PdfCanvas objeto do pacote com.itextpdf.kernel.pdf.canvas passando o criado acima PdfPage objeto ao construtor desta classe, como mostrado abaixo.

// Creating a new page 
PdfPage pdfPage = pdfDoc.addNewPage();           

// Creating a PdfCanvas object 
PdfCanvas canvas = new PdfCanvas(pdfPage);

Etapa 5: Desenhar a linha

Defina o ponto inicial da linha usando o moveTO() método do Canvas classe, conforme mostrado abaixo.

// Initial point of the line 
canvas.moveTo(100, 300);

Agora, desenhe uma linha deste ponto a outro ponto usando o lineTo() método, conforme mostrado abaixo.

// Drawing the line 
canvas.lineTo(500, 300);

Etapa 6: 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 desenhar uma linha em um documento PDF usando a biblioteca iText. Ele cria um documento PDF com o nomedrawingLine.pdf, desenha um arco nele e o salva no caminho C:/itextExamples/

Salve este código em um arquivo com o nome DrawingLine.java.

import com.itextpdf.kernel.pdf.PdfDocument; 
import com.itextpdf.kernel.pdf.PdfPage; 
import com.itextpdf.kernel.pdf.PdfWriter; 
import com.itextpdf.kernel.pdf.canvas.PdfCanvas; 
import com.itextpdf.layout.Document;  

public class DrawingLine {     
   public static void main(String args[]) throws Exception {            
      // Creating a PdfWriter       
      String dest = "C:/itextExamples/drawingLine.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 new page       
      PdfPage pdfPage = pdfDoc.addNewPage();               
      
      // Creating a PdfCanvas object       
      PdfCanvas canvas = new PdfCanvas(pdfPage);              
      
      // Initial point of the line       
      canvas.moveTo(100, 300);              
      
      // Drawing the line       
      canvas.lineTo(500, 300);           
      
      // Closing the path stroke       
      canvas.closePathStroke();              
      
      // Closing the document       
      doc.close();  
      
      System.out.println("Object drawn on pdf successfully");             
   }     
}

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

javac DrawingLine.java 
java DrawingLine

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

Object drawn on pdf successfully

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