public Cell() 
{
		// creates a Rectangle with BY DEFAULT a border of 0.5
		super(0, 0, 0, 0);
		setBorder(UNDEFINED);
		setBorderWidth(0.5f);
		// initializes the arraylist
		arrayList = new ArrayList();
}

Constructs an empty Cell.

 public Cell(boolean dummy) 
{
		this();
		arrayList.add(new Paragraph(0));
}

Constructs an empty Cell (for internal use only).

Parameters:

dummy - a dummy value

 public Cell(String content) 
{
		this();
		try {
			addElement(new Paragraph(content));
		}
		catch(BadElementException bee) {
		}
}

Constructs a Cell with a certain content.

The String will be converted into a Paragraph.

Parameters:

content - a String

 public Cell(Element element) throws BadElementException 
{
		this();
 		if(element instanceof Phrase) {
			setLeading(((Phrase)element).getLeading());
		}
		addElement(element);
}

Constructs a Cell with a certain Element.

if the element is a ListItem, Row or Cell, an exception will be thrown.

Parameters:

element - the element

Throws:

BadElementException - when the creator was called with a ListItem, Row or Cell

 public boolean add(Object o) 
{
		try {
			this.addElement((Element) o);
			return true;
		}
		catch(ClassCastException cce) {
			throw new ClassCastException("You can only add objects that implement the Element interface.");
		}
		catch(BadElementException bee) {
			throw new ClassCastException(bee.getMessage());
		}
}

Add an Object to this cell.

 public  void addElement(Element element) throws BadElementException 
{
		if (isTable()) {
			Table table = (Table) arrayList.get(0);
			Cell tmp = new Cell(element);
			tmp.setBorder(NO_BORDER);
			tmp.setColspan(table.getColumns());
			table.addCell(tmp);
			return;
		}
		switch(element.type()) {
			case Element.LISTITEM:
			case Element.ROW:
			case Element.CELL:
				throw new BadElementException("You can't add listitems, rows or cells to a cell.");
			case Element.LIST:
				List list = (List)element;
				if (Float.isNaN(leading)) {
					setLeading(list.getTotalLeading());
				}
				if (list.isEmpty()) return;
				arrayList.add(element);
				return;
			case Element.ANCHOR:
			case Element.PARAGRAPH:
			case Element.PHRASE:
				Phrase p = (Phrase)element;
				if (Float.isNaN(leading)) {
					setLeading(p.getLeading());
				}
				if (p.isEmpty()) return;
				arrayList.add(element);
				return;
			case Element.CHUNK:
				if (((Chunk) element).isEmpty()) return;
				arrayList.add(element);
				return;
			case Element.TABLE:
				Table table = new Table(3);
				float[] widths = new float[3];
				widths[1] = ((Table)element).getWidth();
				switch(((Table)element).getAlignment()) {
					case Element.ALIGN_LEFT:
						widths[0] = 0f;
						widths[2] = 100f - widths[1];
						break;
					case Element.ALIGN_CENTER:
						widths[0] = (100f - widths[1]) / 2f;
						widths[2] = widths[0];
						break;
					case Element.ALIGN_RIGHT:
						widths[0] = 100f - widths[1];
						widths[2] = 0f;
				}
				table.setWidths(widths);
				Cell tmp;
				if (arrayList.isEmpty()) {
					table.addCell(getDummyCell());
				}
				else {
					tmp = new Cell();
					tmp.setBorder(NO_BORDER);
					tmp.setColspan(3);
					for (Iterator i = arrayList.iterator(); i.hasNext(); ) {
						tmp.add(i.next());
					}
					table.addCell(tmp);
				}
				tmp = new Cell();
				tmp.setBorder(NO_BORDER);
				table.addCell(tmp);
				table.insertTable((Table)element);
				tmp = new Cell();
				tmp.setBorder(NO_BORDER);
				table.addCell(tmp);
				table.addCell(getDummyCell());
				clear();
				arrayList.add(table);
				return;
			default:
				arrayList.add(element);
		}
}

Adds an element to this Cell.

Remark: you can't add ListItems, Rows, Cells, JPEGs, GIFs or PNGs to a Cell.

 public float bottom(int margin) 
{
		throw new UnsupportedOperationException("Dimensions of a Cell can't be calculated. See the FAQ.");
}

This method throws an UnsupportedOperationException.

 public  void clear() 
{
		arrayList.clear();
}

Clears all the Elements of this Cell.

 public PdfPCell createPdfPCell() throws BadElementException 
{
		if (rowspan  > 1) throw new BadElementException("PdfPCells can't have a rowspan  > 1");
		if (isTable()) return new PdfPCell(((Table)arrayList.get(0)).createPdfPTable());
		PdfPCell cell = new PdfPCell();
		cell.setVerticalAlignment(verticalAlignment);
		cell.setHorizontalAlignment(horizontalAlignment);
		cell.setColspan(colspan);
		cell.setUseBorderPadding(useBorderPadding);
		cell.setUseDescender(useDescender);
		cell.setLeading(getLeading(), 0);
		cell.cloneNonPositionParameters(this);
		cell.setNoWrap(getMaxLines() == 1);
		for (Iterator i = getElements(); i.hasNext(); ) {
            Element e = (Element)i.next();
            if (e.type() == Element.PHRASE || e.type() == Element.PARAGRAPH) {
                Paragraph p = new Paragraph((Phrase)e);
                p.setAlignment(horizontalAlignment);
                e = p;
            }
			cell.addElement(e);
		}
		return cell;
}

Creates a PdfPCell based on this Cell object.

  void fill() 
{
		if (size() == 0) arrayList.add(new Paragraph(0));
}

Makes sure there is at least 1 object in the Cell. Otherwise it might not be shown in the table.

 public float getBottom() 
{
		throw new UnsupportedOperationException("Dimensions of a Cell can't be calculated. See the FAQ.");
}

This method throws an UnsupportedOperationException.

 public ArrayList getChunks() 
{
		ArrayList tmp = new ArrayList();
		for (Iterator i = arrayList.iterator(); i.hasNext(); ) {
			tmp.addAll(((Element) i.next()).getChunks());
		}
		return tmp;
}

Gets all the chunks in this element.

 public int getColspan() 
{
		return colspan;
}

Gets the colspan.

 public Iterator getElements() 
{
		return arrayList.iterator();
}

Gets an iterator of Elements.

 public boolean getGroupChange() 
{
		return groupChange;
}

Does this Cell force a group change?

 public int getHorizontalAlignment() 
{
   		return horizontalAlignment;
}

Gets the horizontal alignment.

 public float getLeading() 
{
		if (Float.isNaN(leading)) {
			return 16;
		}
		return leading;
}

Gets the leading.

 public float getLeft() 
{
		throw new UnsupportedOperationException("Dimensions of a Cell can't be calculated. See the FAQ.");
}

This method throws an UnsupportedOperationException.

 public int getMaxLines() 
{
		return maxLines;
}

Getter for maxLines

 public float getRight() 
{
		throw new UnsupportedOperationException("Dimensions of a Cell can't be calculated. See the FAQ.");
}

This method throws an UnsupportedOperationException.

 public int getRowspan() 
{
		return rowspan;
}

Gets the rowspan.

 public String getShowTruncation() 
{
		return showTruncation;
}

Getter for showTruncation

 public float getTop() 
{
		throw new UnsupportedOperationException("Dimensions of a Cell can't be calculated. See the FAQ.");
}

This method throws an UnsupportedOperationException.

 public int getVerticalAlignment() 
{
		return verticalAlignment;
}

Gets the vertical alignment.

 public float getWidth() 
{
		return width;
}

Gets the width.

 public String getWidthAsString() 
{
		String w = String.valueOf(width);
		if (w.endsWith(".0")) w = w.substring(0, w.length() - 2);
		if (percentage) w += "%";
		return w;
}

Gets the width as a String.

 public boolean isEmpty() 
{
		switch(size()) {
			case 0:
				return true;
			case 1:
				Element element = (Element) arrayList.get(0);
				switch (element.type()) {
					case Element.CHUNK:
						return ((Chunk) element).isEmpty();
					case Element.ANCHOR:
					case Element.PHRASE:
					case Element.PARAGRAPH:
						return ((Phrase) element).isEmpty();
					case Element.LIST:
						return ((List) element).isEmpty();
				}
			return false;
			default:
				return false;
		}
}

Checks if the Cell is empty.

 public boolean isHeader() 
{
		return header;
}

Is this Cell a header?

 public boolean isTable() 
{
		return (size() == 1)
			&& (((Element)arrayList.get(0)).type() == Element.TABLE);
}

Checks if this Cell is a placeholder for a (nested) table.

 public boolean isUseAscender() 
{
	    return useAscender;
}

Gets the value of useAscender

 public boolean isUseBorderPadding() 
{
	    return useBorderPadding;
}

Gets the value of useBorderPadding.

 public boolean isUseDescender() 
{
	    return useDescender;
}

gets the value of useDescender

 public float left(int margin) 
{
		throw new UnsupportedOperationException("Dimensions of a Cell can't be calculated. See the FAQ.");
}

This method throws an UnsupportedOperationException.

 public boolean process(ElementListener listener) 
{
		try {
			return listener.add(this);
		}
		catch(DocumentException de) {
			return false;
		}
}

Processes the element by adding it (or the different parts) to an ElementListener.

 public float right(int margin) 
{
		throw new UnsupportedOperationException("Dimensions of a Cell can't be calculated. See the FAQ.");
}

This method throws an UnsupportedOperationException.

 public  void setBottom(int value) 
{
		throw new UnsupportedOperationException("Dimensions of a Cell are attributed automagically. See the FAQ.");
}

This method throws an UnsupportedOperationException.

 public  void setColspan(int value) 
{
		colspan = value;
}

Sets the colspan.

 public  void setGroupChange(boolean value) 
{
		groupChange = value;
}

Sets group change.

 public  void setHeader(boolean value) 
{
		header = value;
}

Sets header.

 public  void setHorizontalAlignment(int value) 
{
		horizontalAlignment = value;
}

Sets the horizontal alignment.

 public  void setHorizontalAlignment(String alignment) 
{
		setHorizontalAlignment(ElementTags.alignmentValue(alignment));
}

Sets the alignment of this cell. This methods allows you to set the alignment as a String.

 public  void setLeading(float value) 
{
		leading = value;
}

Sets the leading.

 public  void setLeft(int value) 
{
		throw new UnsupportedOperationException("Dimensions of a Cell are attributed automagically. See the FAQ.");
}

This method throws an UnsupportedOperationException.

 public  void setMaxLines(int value) 
{
		maxLines = value;
}

Setter for maxLines

 public  void setRight(int value) 
{
		throw new UnsupportedOperationException("Dimensions of a Cell are attributed automagically. See the FAQ.");
}

This method throws an UnsupportedOperationException.

 public  void setRowspan(int value) 
{
		rowspan = value;
}

Sets the rowspan.

 public  void setShowTruncation(String value) 
{
		showTruncation = value;
}

Setter for showTruncation

 public  void setTop(int value) 
{
		throw new UnsupportedOperationException("Dimensions of a Cell are attributed automagically. See the FAQ.");
}

This method throws an UnsupportedOperationException.

 public  void setUseAscender(boolean use) 
{
	    useAscender = use;
}

Sets the value of useAscender.

 public  void setUseBorderPadding(boolean use) 
{
	    useBorderPadding = use;
}

Sets the value of useBorderPadding.

 public  void setUseDescender(boolean use) 
{
	    useDescender = use;
}

Sets the value of useDescender.

 public  void setVerticalAlignment(int value) 
{
		verticalAlignment = value;
}

Sets the vertical alignment.

 public  void setVerticalAlignment(String alignment) 
{
		setVerticalAlignment(ElementTags.alignmentValue(alignment));
}

Sets the alignment of this paragraph.

 public  void setWidth(float value) 
{
		this.width = value;
}

Sets the width.

 public  void setWidth(String value) 
{
		if (value.endsWith("%")) {
			value = value.substring(0, value.length() - 1);
			percentage = true;
		}
		width = Integer.parseInt(value);
}

Sets the width. It can be an absolute value "100" or a percentage "20%"

 public int size() 
{
		return arrayList.size();
}

Gets the number of Elements in the Cell.

 public float top(int margin) 
{
		throw new UnsupportedOperationException("Dimensions of a Cell can't be calculated. See the FAQ.");
}

This method throws an UnsupportedOperationException.

 public int type() 
{
		return Element.CELL;
}

Gets the type of the text element.