com.itextpdf.layout.element

Class Cell

java.lang.Object

com.itextpdf.layout.ElementPropertyContainer<T>

com.itextpdf.layout.element.AbstractElement<T>

com.itextpdf.layout.element.BlockElement<Cell>

com.itextpdf.layout.element.Cell

All Implemented Interfaces:

IAccessibleElement, IElement, IPropertyContainer

public class Cell
extends BlockElement<Cell>

A Cell is one piece of data in an enclosing grid, the Table. This object is a BlockElement, giving it a number of visual layout properties. A cell can act as a container for a number of layout elements; it can only contain other BlockElement objects or images. Other types of layout elements must be wrapped in a BlockElement.

Field Summary

Fields

Modifier and Type	Field and Description
protected PdfName	role
protected AccessibilityProperties	tagProperties

Fields inherited from class com.itextpdf.layout.element.AbstractElement

childElements, nextRenderer, styles

Fields inherited from class com.itextpdf.layout.ElementPropertyContainer

properties

Constructor Summary

Constructors

Constructor and Description
Cell() Creates a cell.
Cell(int rowspan, int colspan) Creates a cell which takes a custom amount of cell spaces in the table.

Method Summary

Modifier and Type	Method and Description
<T extends IElement> Cell	add(BlockElement<T> element) Adds any block element to the cell's contents.
Cell	add(Image element) Adds an image to the cell's contents.
Cell	add(String content) Directly adds a String of text to this cell.
Cell	add(Table element) Adds an embedded table to the cell's contents.
Cell	clone(boolean includeContent) Clones a cell with its position, properties, and optionally its contents.
AccessibilityProperties	getAccessibilityProperties()
int	getCol()
int	getColspan()
<T1> T1	getDefaultProperty(int property) Gets the default property from this entity.
IRenderer	getRenderer() Gets a cell renderer for this element.
PdfName	getRole()
int	getRow()
int	getRowspan()
protected IRenderer	makeNewRenderer()
void	setRole(PdfName role)
String	toString()
protected Cell	updateCellIndexes(int row, int col, int numberOfColumns)

Methods inherited from class com.itextpdf.layout.element.BlockElement

getMarginBottom, getMarginLeft, getMarginRight, getMarginTop, getPaddingBottom, getPaddingLeft, getPaddingRight, getPaddingTop, isKeepTogether, setKeepTogether, setMargin, setMarginBottom, setMarginLeft, setMarginRight, setMargins, setMarginTop, setPadding, setPaddingBottom, setPaddingLeft, setPaddingRight, setPaddings, setPaddingTop, setRotationAngle, setRotationAngle, setSpacingRatio, setVerticalAlignment

Methods inherited from class com.itextpdf.layout.element.AbstractElement

addStyle, createRendererSubTree, getProperty, hasProperty, isEmpty, propagateArtifactRoleToChildElements, setAction, setNextRenderer, setPageNumber

Methods inherited from class com.itextpdf.layout.ElementPropertyContainer

deleteOwnProperty, getHeight, getOwnProperty, getSplitCharacters, getStrokeColor, getStrokeWidth, getTextRenderingMode, getWidth, hasOwnProperty, setBackgroundColor, setBackgroundColor, setBaseDirection, setBold, setBorder, setBorderBottom, setBorderLeft, setBorderRight, setBorderTop, setCharacterSpacing, setDestination, setFixedPosition, setFixedPosition, setFixedPosition, setFixedPosition, setFont, setFontColor, setFontKerning, setFontScript, setFontSize, setHeight, setHorizontalAlignment, setHyphenation, setItalic, setLineThrough, setProperty, setRelativePosition, setSplitCharacters, setStrokeColor, setStrokeWidth, setTextAlignment, setTextRenderingMode, setUnderline, setUnderline, setUnderline, setWidth, setWidth, setWidthPercent, setWordSpacing

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface com.itextpdf.layout.IPropertyContainer

deleteOwnProperty, getOwnProperty, hasOwnProperty, setProperty

Field Detail

role

protected PdfName role

tagProperties

protected AccessibilityProperties tagProperties

Constructor Detail

Cell

public Cell(int rowspan,
            int colspan)

Creates a cell which takes a custom amount of cell spaces in the table.

Parameters:

rowspan - the number of rows this cell must occupy. Negative numbers will make the argument default to 1.

colspan - the number of columns this cell must occupy. Negative numbers will make the argument default to 1.

Cell

public Cell()

Creates a cell.

Method Detail

getRenderer

public IRenderer getRenderer()

Gets a cell renderer for this element. Note that this method can be called more than once. By default each element should define its own renderer, but the renderer can be overridden by AbstractElement.setNextRenderer(IRenderer) method call.

Specified by:

getRenderer in interface IElement

Overrides:

getRenderer in class AbstractElement<Cell>

Returns:

a cell renderer for this element

getRow

public int getRow()

getCol

public int getCol()

getRowspan

public int getRowspan()

getColspan

public int getColspan()

add

public <T extends IElement> Cell add(BlockElement<T> element)

Adds any block element to the cell's contents.

Parameters:

element - a BlockElement

Returns:

this Element

add

public Cell add(Image element)

Adds an image to the cell's contents.

Parameters:

element - an Image

Returns:

this Element

add

public Cell add(Table element)

Adds an embedded table to the cell's contents.

Parameters:

element - a nested Table

Returns:

this Element

add

public Cell add(String content)

Directly adds a String of text to this cell. The content is wrapped in a layout element.

Parameters:

content - a String

Returns:

this Element

clone

public Cell clone(boolean includeContent)

Clones a cell with its position, properties, and optionally its contents.

Parameters:

includeContent - whether or not to also include the contents of the cell.

Returns:

a clone of this Element

getDefaultProperty

public <T1> T1 getDefaultProperty(int property)

Description copied from interface: IPropertyContainer

Gets the default property from this entity.

Specified by:

getDefaultProperty in interface IPropertyContainer

Overrides:

getDefaultProperty in class BlockElement<Cell>

Type Parameters:

T1 - the return type associated with the property

Parameters:

property - the property to be retrieved

Returns:

the default property value. If the default property is not defined, null will be returned

toString

public String toString()

Overrides:

toString in class Object

getRole

public PdfName getRole()

setRole

public void setRole(PdfName role)

getAccessibilityProperties

public AccessibilityProperties getAccessibilityProperties()

makeNewRenderer

protected IRenderer makeNewRenderer()

Specified by:

makeNewRenderer in class AbstractElement<Cell>

updateCellIndexes

protected Cell updateCellIndexes(int row,
                                 int col,
                                 int numberOfColumns)