Java Doc for Table.java in  » PDF » pdf-itext » com » lowagie » text » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Tables that span multiple pages are cut into different parts automatically. If you want a table header to be repeated on every page, you may not forget to mark the end of the header section by using the method endHeaders().

The matrix of a table is not necessarily an m x n-matrix. It can contain holes or cells that are bigger than the unit. Believe me or not, but it took some serious thinking to make this as userfriendly as possible. I hope you wil find the result quite simple (I love simple solutions, especially for complex problems). I didn't want it to be something as complex as the Java GridBagLayout.

Example:

 // Remark: You MUST know the number of columns when constructing a Table.
 //         The number of rows is not important.
 Table table = new Table(3);
 table.setBorderWidth(1);
 table.setBorderColor(new Color(0, 0, 255));
 table.setPadding(5);
 table.setSpacing(5);
 Cell cell = new Cell("header");
 cell.setHeader(true);
 cell.setColspan(3);
 table.addCell(cell);
 table.endHeaders();
 cell = new Cell("example cell with colspan 1 and rowspan 2");
 cell.setRowspan(2);
 cell.setBorderColor(new Color(255, 0, 0));
 table.addCell(cell);
 table.addCell("1.1");
 table.addCell("2.1");
 table.addCell("1.2");
 table.addCell("2.2");
 table.addCell("cell test1");
 cell = new Cell("big cell");
 cell.setRowspan(2);
 cell.setColspan(2);
 table.addCell(cell);
 table.addCell("cell test2");
 

This is a shortcut for addCell(Cell cell). The Phrase will be converted to a Cell.
Parameters:
  content - a Phrase
throws:
  BadElementException - this should never happen

This is a shortcut for addCell(Cell cell, Point location). The Phrase will be converted to a Cell.
Parameters:
  content - a Phrase
Parameters:
  location - a Point
throws:
  BadElementException - this should never happen

This is a shortcut for addCell(Cell cell). The String will be converted to a Cell.
Parameters:
  content - a String
throws:
  BadElementException - this should never happen

This is a shortcut for addCell(Cell cell, Point location). The String will be converted to a Cell.
Parameters:
  content - a String
Parameters:
  location - a Point
throws:
  BadElementException - this should never happen

This method translates the widths expressed in percentages into the x-coordinate of the borders of the columns on a real document.
Parameters:
  left - this is the position of the first border at the left (cellpadding not included)
Parameters:
  totalWidth - this is the space between the first border at the leftand the last border at the right (cellpadding not included) an array with borderpositions

When a cell doesn't fit a page, it is split in two parts. If you want to avoid this, you should set the cellsFitPage value to true.
Parameters:
  fitPage - enter true if you don't want to split cells

When a table doesn't fit a page, it is split in two parts. If you want to avoid this, you should set the tableFitsPage value to true.
Parameters:
  fitPage - enter true if you don't want to split cells

You can give up relative values of borderwidths. The sum of these values will be considered 100%. The values will be recalculated as percentages of this sum.

example:

 float[] widths = {2, 1, 1};
 table.setWidths(widths)
 

You can give up relative values of borderwidths. The sum of these values will be considered 100%. The values will be recalculated as percentages of this sum.
Parameters:
  widths - an array with values
throws:
  DocumentException -