iText - Formatando Conteúdo de Células
Neste capítulo, veremos como criar um documento PDF e adicionar uma tabela e formatar o conteúdo de uma célula na tabela usando a biblioteca iText.
Formatando as células em uma tabela
Você pode criar um PDF vazio Documentinstanciando a classe Document. 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. Você pode formatar o conteúdo de uma célula em uma tabela usando os métodos doCell classe.
A seguir estão as etapas para formatar o conteúdo de uma célula em uma tabela.
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/addingBackground.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 PDFDocument 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 classe passando o criado acima PdfWriter objeto ao seu construtor, como mostrado abaixo.
// Creating a PdfDocument
PdfDocument pdfDoc = new PdfDocument(writer);
Uma vez por PdfDocument objeto é 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 Tabela
o Tableclasse representa uma grade bidimensional preenchida com células, ordenadas em linhas e colunas. Pertence ao pacotecom.itextpdf.layout.element.
Instancie a classe Table conforme mostrado abaixo.
// Creating a table
float [] pointColumnWidths = {200F, 200F};
Table table = new Table(pointColumnWidths);
Etapa 5: Criação de células
Criar uma cell objeto instanciando o Cell classe do pacote com.itextpdf.layout.element. Adicione o conteúdo da célula usando oadd() método do Cell classe, conforme mostrado abaixo.
// Adding cell 1 to the table
Cell cell1 = new Cell(); // Creating a cell
cell1.add("Name"); // Adding content to the cell
// Adding cell 2 to the table
Cell cell2 = new Cell(); // Creating a cell
cell2.add("Raju"); // Adding content to the cell
Etapa 6: Adicionar plano de fundo à célula
Depois de criar a célula e adicionar conteúdo a ela, você pode formatar a célula. Por exemplo, você pode definir seu plano de fundo, alinhar o texto dentro da célula, alterar a cor do texto, etc., usando diferentes métodos da classe de célula, comosetBackgroundColor(), setBorder(), setTextAlignment().
Você pode definir a cor de fundo, a borda e o alinhamento do texto para a célula criada na etapa anterior, conforme mostrado abaixo.
c1.setBackgroundColor(Color.DARK_GRAY); // Setting background color to cell1
c1.setBorder(Border.NO_BORDER); // Setting border to cell1
c1.setTextAlignment(TextAlignment.CENTER); // Setting text alignment to cell1
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(c1);
Etapa 8: Adicionando tabela ao documento
Adicione o table objeto criado na etapa anterior usando o add() método do Document classe como 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 formatar o conteúdo de uma célula em uma tabela usando a biblioteca iText. Ele cria um documento PDF com o nomeaddingBackground.pdf, adiciona uma tabela a ele, formata o conteúdo de suas células e o salva no caminho C:/itextExamples/
Salve este código em um arquivo com o nome BackgroundToTable.java.
import com.itextpdf.kernel.color.Color;
import com.itextpdf.kernel.pdf.PdfDocument;
import com.itextpdf.kernel.pdf.PdfWriter;
import com.itextpdf.layout.Document;
import com.itextpdf.layout.border.Border;
import com.itextpdf.layout.element.Cell;
import com.itextpdf.layout.element.Table;
import com.itextpdf.layout.property.TextAlignment;
public class BackgroundToTable {
public static void main(String args[]) throws Exception {
// Creating a PdfWriter object
String dest = "C:/itextExamples/addingBackground.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 = {200F, 200F};
Table table = new Table(pointColumnWidths);
// Populating row 1 and adding it to the table
Cell c1 = new Cell(); // Creating cell 1
c1.add("Name"); // Adding name to cell 1
c1.setBackgroundColor(Color.DARK_GRAY); // Setting background color
c1.setBorder(Border.NO_BORDER); // Setting border
c1.setTextAlignment(TextAlignment.CENTER); // Setting text alignment
table.addCell(c1); // Adding cell 1 to the table
Cell c2 = new
Cell();
c2.add("Raju");
c2.setBackgroundColor(Color.GRAY);
c2.setBorder(Border.NO_BORDER);
c2.setTextAlignment(TextAlignment.CENTER);
table.addCell(c2);
// Populating row 2 and adding it to the table
Cell c3 = new Cell();
c3.add("Id");
c3.setBackgroundColor(Color.WHITE);
c3.setBorder(Border.NO_BORDER);
c3.setTextAlignment(TextAlignment.CENTER);
table.addCell(c3);
Cell c4 = new Cell();
c4.add("001");
c4.setBackgroundColor(Color.WHITE);
c4.setBorder(Border.NO_BORDER);
c4.setTextAlignment(TextAlignment.CENTER);
table.addCell(c4);
// Populating row 3 and adding it to the table
Cell c5 = new Cell();
c5.add("Designation");
c5.setBackgroundColor(Color.DARK_GRAY);
c5.setBorder(Border.NO_BORDER);
c5.setTextAlignment(TextAlignment.CENTER);
table.addCell(c5);
Cell c6 = new Cell();
c6.add("Programmer");
c6.setBackgroundColor(Color.GRAY);
c6.setBorder(Border.NO_BORDER);
c6.setTextAlignment(TextAlignment.CENTER);
table.addCell(c6);
// Adding Table to document
doc.add(table);
// Closing the document
doc.close();
System.out.println("Background added successfully..");
}
}
Compile e execute o arquivo Java salvo no prompt de comando usando os seguintes comandos -
javac BackgroundToTable.java
java BackgroundToTable
Após a execução, o programa acima cria um documento PDF, exibindo a seguinte mensagem.
Background added successfully..
Se você verificar o caminho especificado, poderá encontrar o documento PDF criado, conforme mostrado abaixo.