com.lowagie.text

Class Row

Implemented Interfaces:
Element, MarkupAttributes

public class Row
extends java.lang.Object
implements Element, MarkupAttributes

A Row is part of a Table and contains some Cells.

All Rows are constructed by a Table-object. You don't have to construct any Row yourself. In fact you can't construct a Row outside the package.

Since a Cell can span several rows and/or columns a row can contain reserved space without any content.

See Also:
Element, Cell, Table

Field Summary

static int
CELL
id of the Cell element in a Row
static int
NULL
id of a null element in a Row
static int
TABLE
id of the Table element in a Row
protected Object[]
cells
This is the array of Objects (Cell or Table).
protected int
columns
This is the number of columns in the Row.
protected int
currentColumn
This is a valid position the Row.
protected int
horizontalAlignment
This is the vertical alignment.
protected Properties
markupAttributes
Contains extra markupAttributes
protected boolean[]
reserved
This is the array that keeps track of reserved cells.
protected int
verticalAlignment
This is the vertical alignment.

Fields inherited from interface com.lowagie.text.Element

ALIGN_BASELINE, ALIGN_BOTTOM, ALIGN_CENTER, ALIGN_JUSTIFIED, ALIGN_JUSTIFIED_ALL, ALIGN_LEFT, ALIGN_MIDDLE, ALIGN_RIGHT, ALIGN_TOP, ALIGN_UNDEFINED, ANCHOR, ANNOTATION, AUTHOR, CCITTG3_1D, CCITTG3_2D, CCITTG4, CCITT_BLACKIS1, CCITT_ENCODEDBYTEALIGN, CCITT_ENDOFBLOCK, CCITT_ENDOFLINE, CELL, CHAPTER, CHUNK, CREATIONDATE, CREATOR, GRAPHIC, HEADER, IMGRAW, IMGTEMPLATE, JPEG, KEYWORDS, LIST, LISTITEM, MULTI_COLUMN_TEXT, PARAGRAPH, PHRASE, PRODUCER, PTABLE, RECTANGLE, ROW, SECTION, SUBJECT, TABLE, TITLE

Constructor Summary

Row(int columns)
Constructs a Row with a certain number of columns.

Method Summary

(package private) int
addElement(Object element)
Adds a Cell to the Row.
(package private) int
addElement(Object element, int column)
Adds an element to the Row at the position given.
int
columns()
Gets the number of columns.
(package private) void
deleteColumn(int column)
Returns a Row that is a copy of this Row in which a certain column has been deleted.
Object
getCell(int column)
Gets a Cell or Table from a certain column.
ArrayList
getChunks()
Gets all the chunks in this element.
(package private) int
getElementID(int column)
Returns the type-id of the element in a Row.
String
getMarkupAttribute(String name)
Set
getMarkupAttributeNames()
Properties
getMarkupAttributes()
(package private) int
getObjectID(Object element)
Returns the type-id of an Object.
int
horizontalAlignment()
Gets the horizontal alignment.
boolean
isEmpty()
Checks if the row is empty.
(package private) boolean
isReserved(int column)
Returns true/false when this position in the Row has been reserved, either filled or through a colspan of an Element.
static boolean
isTag(String tag)
Checks if a given tag corresponds with this object.
boolean
process(ElementListener listener)
Processes the element by adding it (or the different parts) to a ElementListener.
(package private) boolean
reserve(int column)
Reserves a Cell in the Row.
(package private) boolean
reserve(int column, int size)
Reserves a Cell in the Row.
(package private) void
setElement(Object aElement, int column)
Puts Cell to the Row at the position given, doesn't reserve colspan.
void
setHorizontalAlignment(int value)
Sets the horizontal alignment.
void
setMarkupAttribute(String name, String value)
void
setMarkupAttributes(Properties markupAttributes)
void
setVerticalAlignment(int value)
Sets the vertical alignment.
int
type()
Gets the type of the text element.
(package private) int
validPosition()
Gets the index of the current, valid position
int
verticalAlignment()
Gets the vertical alignment.

Field Details

CELL

public static final int CELL
id of the Cell element in a Row
Field Value:
1

NULL

public static final int NULL
id of a null element in a Row
Field Value:
0

TABLE

public static final int TABLE
id of the Table element in a Row
Field Value:
2

cells

protected Object[] cells
This is the array of Objects (Cell or Table).

columns

protected int columns
This is the number of columns in the Row.

currentColumn

protected int currentColumn
This is a valid position the Row.

horizontalAlignment

protected int horizontalAlignment
This is the vertical alignment.

markupAttributes

protected Properties markupAttributes
Contains extra markupAttributes

reserved

protected boolean[] reserved
This is the array that keeps track of reserved cells.

verticalAlignment

protected int verticalAlignment
This is the vertical alignment.

Constructor Details

Row

protected Row(int columns)
Constructs a Row with a certain number of columns.
Parameters:
columns - a number of columns

Method Details

addElement

(package private)  int addElement(Object element)
Adds a Cell to the Row.
Parameters:
element - the element to add (currently only Cells and Tables supported)
Returns:
the column position the Cell was added, or -1 if the element couldn't be added.

addElement

(package private)  int addElement(Object element,
                                  int column)
Adds an element to the Row at the position given.
Parameters:
element - the element to add. (currently only Cells and Tables supported
column - the position where to add the cell.
Returns:
the column position the Cell was added, or -1 if the Cell couldn't be added.

columns

public int columns()
Gets the number of columns.
Returns:
a value

deleteColumn

(package private)  void deleteColumn(int column)
Returns a Row that is a copy of this Row in which a certain column has been deleted.
Parameters:
column - the number of the column to delete

getCell

public Object getCell(int column)
Gets a Cell or Table from a certain column.
Parameters:
column - the column the Cell/Table is in.
Returns:
the Cell,Table or Object if the column was reserved or null if empty.

getChunks

public ArrayList getChunks()
Gets all the chunks in this element.
Specified by:
getChunks in interface Element
Returns:
an ArrayList

getElementID

(package private)  int getElementID(int column)
Returns the type-id of the element in a Row.
Parameters:
column - the column of which you'd like to know the type
Returns:
the type-id of the element in the row

getMarkupAttribute

public String getMarkupAttribute(String name)
Specified by:
getMarkupAttribute in interface MarkupAttributes
See Also:
com.lowagie.text.MarkupAttributes.getMarkupAttribute(java.lang.String)

getMarkupAttributeNames

public Set getMarkupAttributeNames()
Specified by:
getMarkupAttributeNames in interface MarkupAttributes

getMarkupAttributes

public Properties getMarkupAttributes()
Specified by:
getMarkupAttributes in interface MarkupAttributes

getObjectID

(package private)  int getObjectID(Object element)
Returns the type-id of an Object.
Parameters:
element - the object of which you'd like to know the type-id, -1 if invalid
Returns:
the type-id of an object

horizontalAlignment

public int horizontalAlignment()
Gets the horizontal alignment.
Returns:
a value

isEmpty

public boolean isEmpty()
Checks if the row is empty.
Returns:
true if none of the columns is reserved.

isReserved

(package private)  boolean isReserved(int column)
Returns true/false when this position in the Row has been reserved, either filled or through a colspan of an Element.
Parameters:
column - the column.
Returns:
true if the column was reserved, false if not.

isTag

public static boolean isTag(String tag)
Checks if a given tag corresponds with this object.
Parameters:
tag - the given tag
Returns:
true if the tag corresponds

process

public boolean process(ElementListener listener)
Processes the element by adding it (or the different parts) to a ElementListener.
Specified by:
process in interface Element
Parameters:
listener - an ElementListener
Returns:
true if the element was processed successfully

reserve

(package private)  boolean reserve(int column)
Reserves a Cell in the Row.
Parameters:
column - the column that has to be reserved.
Returns:
true if the column was reserved, false if not.

reserve

(package private)  boolean reserve(int column,
                                   int size)
Reserves a Cell in the Row.
Parameters:
column - the column that has to be reserved.
size - the number of columns
Returns:
true if the column was reserved, false if not.

setElement

(package private)  void setElement(Object aElement,
                                   int column)
Puts Cell to the Row at the position given, doesn't reserve colspan.
Parameters:
aElement - the cell to add.
column - the position where to add the cell.

setHorizontalAlignment

public void setHorizontalAlignment(int value)
Sets the horizontal alignment.
Parameters:
value - the new value

setMarkupAttribute

public void setMarkupAttribute(String name,
                               String value)
Specified by:
setMarkupAttribute in interface MarkupAttributes
See Also:
com.lowagie.text.MarkupAttributes.setMarkupAttribute(java.lang.String, java.lang.String)

setMarkupAttributes

public void setMarkupAttributes(Properties markupAttributes)
Specified by:
setMarkupAttributes in interface MarkupAttributes
See Also:
com.lowagie.text.MarkupAttributes.setMarkupAttributes(java.util.Properties)

setVerticalAlignment

public void setVerticalAlignment(int value)
Sets the vertical alignment.
Parameters:
value - the new value

type

public int type()
Gets the type of the text element.
Specified by:
type in interface Element
Returns:
a type

validPosition

(package private)  int validPosition()
Gets the index of the current, valid position
Returns:
a value

verticalAlignment

public int verticalAlignment()
Gets the vertical alignment.
Returns:
a value