com.lowagie.text
Class Paragraph

java.lang.Object
  |
  +--java.util.AbstractCollection
        |
        +--java.util.AbstractList
              |
              +--java.util.ArrayList
                    |
                    +--com.lowagie.text.Phrase
                          |
                          +--com.lowagie.text.Paragraph
All Implemented Interfaces:
Cloneable, Collection, Element, List, MarkupAttributes, RandomAccess, Serializable, TextElementArray
Direct Known Subclasses:
ListItem

public class Paragraph
extends Phrase
implements TextElementArray, MarkupAttributes

A Paragraph is a series of Chunks and/or Phrases.

A Paragraph has the same qualities of a Phrase, but also some additional layout-parameters:

Example:
 Paragraph p = new Paragraph("This is a paragraph",
               FontFactory.getFont(FontFactory.HELVETICA, 18, Font.BOLDITALIC, new Color(0, 0, 255)));
 

See Also:
Element, Phrase, ListItem, Serialized Form

Field Summary
protected  int alignment
          The alignment of the text.
protected  float indentationLeft
          The indentation of this paragraph on the left side.
protected  float indentationRight
          The indentation of this paragraph on the right side.
protected  boolean keeptogether
          Does the paragraph has to be kept together on 1 page.
 
Fields inherited from class com.lowagie.text.Phrase
font, leading, markupAttributes
 
Fields inherited from class java.util.ArrayList
 
Fields inherited from class java.util.AbstractList
modCount
 
Fields inherited from interface com.lowagie.text.Element
ALIGN_BASELINE, ALIGN_BOTTOM, ALIGN_CENTER, ALIGN_JUSTIFIED, ALIGN_LEFT, ALIGN_MIDDLE, ALIGN_RIGHT, ALIGN_TOP, ALIGN_UNDEFINED, ANCHOR, ANNOTATION, AUTHOR, CCITT_BLACKIS1, CCITT_ENCODEDBYTEALIGN, CCITT_ENDOFBLOCK, CCITT_ENDOFLINE, CCITTG3_1D, CCITTG3_2D, CCITTG4, CELL, CHAPTER, CHUNK, CREATIONDATE, CREATOR, GRAPHIC, HEADER, IMGRAW, IMGTEMPLATE, JPEG, KEYWORDS, LIST, LISTITEM, PARAGRAPH, PHRASE, PRODUCER, PTABLE, RECTANGLE, ROW, SECTION, SUBJECT, TABLE, TITLE
 
Constructor Summary
Paragraph()
          Constructs a Paragraph.
Paragraph(Chunk chunk)
          Constructs a Paragraph with a certain Chunk.
Paragraph(float leading)
          Constructs a Paragraph with a certain leading.
Paragraph(float leading, Chunk chunk)
          Constructs a Paragraph with a certain Chunk and a certain leading.
Paragraph(float leading, String string)
          Constructs a Paragraph with a certain String and a certain leading.
Paragraph(float leading, String string, Font font)
          Constructs a Paragraph with a certain leading, String and Font.
Paragraph(Phrase phrase)
          Constructs a Paragraph with a certain Phrase.
Paragraph(Properties attributes)
          Returns a Paragraph that has been constructed taking in account the value of some attributes.
Paragraph(String string)
          Constructs a Paragraph with a certain String.
Paragraph(String string, Font font)
          Constructs a Paragraph with a certain String and a certain Font.
 
Method Summary
 boolean add(Object o)
          Adds an Object to the Paragraph.
 int alignment()
          Gets the alignment of this paragraph.
 boolean getKeepTogether()
          Checks if this paragraph has to be kept together on one page.
 float indentationLeft()
          Gets the indentation of this paragraph on the left side.
 float indentationRight()
          Gets the indentation of this paragraph on the right side.
static boolean isTag(String tag)
          Checks if a given tag corresponds with this object.
 void setAlignment(int alignment)
          Sets the alignment of this paragraph.
 void setAlignment(String alignment)
          Sets the alignment of this paragraph.
 void setIndentationLeft(float indentation)
          Sets the indentation of this paragraph on the left side.
 void setIndentationRight(float indentation)
          Sets the indentation of this paragraph on the right side.
 void setKeepTogether(boolean keeptogether)
          Indicates that the paragraph has to be kept together on one page.
 int type()
          Gets the type of the text element.
 
Methods inherited from class com.lowagie.text.Phrase
add, addAll, addSpecial, font, getChunks, getMarkupAttribute, getMarkupAttributeNames, getMarkupAttributes, isEmpty, leading, leadingDefined, process, setLeading, setMarkupAttribute, setMarkupAttributes
 
Methods inherited from class java.util.ArrayList
addAll, clear, clone, contains, ensureCapacity, get, indexOf, lastIndexOf, remove, removeRange, set, size, toArray, toArray, trimToSize
 
Methods inherited from class java.util.AbstractList
equals, hashCode, iterator, listIterator, listIterator, subList
 
Methods inherited from class java.util.AbstractCollection
containsAll, remove, removeAll, retainAll, toString
 
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface com.lowagie.text.Element
getChunks, process, toString
 
Methods inherited from interface com.lowagie.text.MarkupAttributes
getMarkupAttribute, getMarkupAttributeNames, getMarkupAttributes, setMarkupAttribute, setMarkupAttributes
 
Methods inherited from interface java.util.List
containsAll, equals, hashCode, iterator, listIterator, listIterator, remove, removeAll, retainAll, subList
 

Field Detail

alignment

protected int alignment
The alignment of the text.


indentationLeft

protected float indentationLeft
The indentation of this paragraph on the left side.


indentationRight

protected float indentationRight
The indentation of this paragraph on the right side.


keeptogether

protected boolean keeptogether
Does the paragraph has to be kept together on 1 page.

Constructor Detail

Paragraph

public Paragraph()
Constructs a Paragraph.


Paragraph

public Paragraph(float leading)
Constructs a Paragraph with a certain leading.

Parameters:
leading - the leading

Paragraph

public Paragraph(Chunk chunk)
Constructs a Paragraph with a certain Chunk.

Parameters:
chunk - a Chunk

Paragraph

public Paragraph(float leading,
                 Chunk chunk)
Constructs a Paragraph with a certain Chunk and a certain leading.

Parameters:
leading - the leading
chunk - a Chunk

Paragraph

public Paragraph(String string)
Constructs a Paragraph with a certain String.

Parameters:
string - a String

Paragraph

public Paragraph(String string,
                 Font font)
Constructs a Paragraph with a certain String and a certain Font.

Parameters:
string - a String
font - a Font

Paragraph

public Paragraph(float leading,
                 String string)
Constructs a Paragraph with a certain String and a certain leading.

Parameters:
leading - the leading
string - a String

Paragraph

public Paragraph(float leading,
                 String string,
                 Font font)
Constructs a Paragraph with a certain leading, String and Font.

Parameters:
leading - the leading
string - a String
font - a Font

Paragraph

public Paragraph(Phrase phrase)
Constructs a Paragraph with a certain Phrase.

Parameters:
phrase - a Phrase

Paragraph

public Paragraph(Properties attributes)
Returns a Paragraph that has been constructed taking in account the value of some attributes.

Parameters:
attributes - Some attributes
Method Detail

type

public int type()
Gets the type of the text element.

Specified by:
type in interface Element
Overrides:
type in class Phrase
Returns:
a type

add

public boolean add(Object o)
Adds an Object to the Paragraph.

Specified by:
add in interface TextElementArray
Overrides:
add in class Phrase
Parameters:
o - object the object to add.
Returns:
true if the addition succeeded; false otherwise

setAlignment

public void setAlignment(int alignment)
Sets the alignment of this paragraph.

Parameters:
alignment - the new alignment

setAlignment

public void setAlignment(String alignment)
Sets the alignment of this paragraph.

Parameters:
alignment - the new alignment as a String

setIndentationLeft

public void setIndentationLeft(float indentation)
Sets the indentation of this paragraph on the left side.

Parameters:
indentation - the new indentation

setIndentationRight

public void setIndentationRight(float indentation)
Sets the indentation of this paragraph on the right side.

Parameters:
indentation - the new indentation

setKeepTogether

public void setKeepTogether(boolean keeptogether)
Indicates that the paragraph has to be kept together on one page.

Parameters:
keeptogether - true of the paragraph may not be split over 2 pages

getKeepTogether

public boolean getKeepTogether()
Checks if this paragraph has to be kept together on one page.

Returns:
true if the paragraph may not be split over 2 pages.

alignment

public int alignment()
Gets the alignment of this paragraph.

Returns:
alignment

indentationLeft

public float indentationLeft()
Gets the indentation of this paragraph on the left side.

Returns:
the indentation

indentationRight

public float indentationRight()
Gets the indentation of this paragraph on the right side.

Returns:
the indentation

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