Package com.itextpdf.text
Class Paragraph
- java.lang.Object
-
- java.util.AbstractCollection<E>
-
- java.util.AbstractList<E>
-
- java.util.ArrayList<Element>
-
- com.itextpdf.text.Phrase
-
- com.itextpdf.text.Paragraph
-
- All Implemented Interfaces:
Indentable,Spaceable,Element,IAccessibleElement,TextElementArray,java.io.Serializable,java.lang.Cloneable,java.lang.Iterable<Element>,java.util.Collection<Element>,java.util.List<Element>,java.util.RandomAccess
- Direct Known Subclasses:
ListItem
public class Paragraph extends Phrase implements Indentable, Spaceable, IAccessibleElement
AParagraphis a series ofChunks and/orPhrases.A
Paragraphhas the same qualities of aPhrase, but also some additional layout-parameters:- the indentation
- the alignment of the text
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
Fields Modifier and Type Field Description protected java.util.HashMap<PdfName,PdfObject>accessibleAttributesprotected intalignmentThe alignment of the text.private floatextraParagraphSpaceHolds value of property extraParagraphSpace.private floatfirstLineIndentHolds value of property firstLineIndent.protected AccessibleElementIdidprotected floatindentationLeftThe indentation of this paragraph on the left side.protected floatindentationRightThe indentation of this paragraph on the right side.protected booleankeeptogetherDoes the paragraph has to be kept together on 1 page.protected floatpaddingTopprotected PdfNameroleprivate static longserialVersionUIDprotected floatspacingAfterThe spacing after the paragraph.protected floatspacingBeforeThe spacing before the paragraph.-
Fields inherited from class com.itextpdf.text.Phrase
font, hyphenation, leading, multipliedLeading, tabSettings
-
Fields inherited from interface com.itextpdf.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, BODY, CCITT_BLACKIS1, CCITT_ENCODEDBYTEALIGN, CCITT_ENDOFBLOCK, CCITT_ENDOFLINE, CCITTG3_1D, CCITTG3_2D, CCITTG4, CHAPTER, CHUNK, CREATIONDATE, CREATOR, DIV, HEADER, IMGRAW, IMGTEMPLATE, JBIG2, JPEG, JPEG2000, KEYWORDS, LANGUAGE, LIST, LISTITEM, MARKED, PARAGRAPH, PHRASE, PRODUCER, PTABLE, RECTANGLE, SECTION, SUBJECT, TITLE, WRITABLE_DIRECT, YMARK
-
-
Constructor Summary
Constructors Constructor Description Paragraph()Constructs aParagraph.Paragraph(float leading)Constructs aParagraphwith a certain leading.Paragraph(float leading, Chunk chunk)Constructs aParagraphwith a certainChunkand a certain leading.Paragraph(float leading, java.lang.String string)Constructs aParagraphwith a certainStringand a certain leading.Paragraph(float leading, java.lang.String string, Font font)Constructs aParagraphwith a certain leading,StringandFont.Paragraph(Chunk chunk)Constructs aParagraphwith a certainChunk.Paragraph(Phrase phrase)Constructs aParagraphwith a certainPhrase.Paragraph(java.lang.String string)Constructs aParagraphwith a certainString.Paragraph(java.lang.String string, Font font)Constructs aParagraphwith a certainStringand a certainFont.
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description booleanadd(Element o)Adds anElementto theParagraph.java.util.List<Element>breakUp()Breaks this Paragraph up in different parts, separating paragraphs, lists and tables from each other.ParagraphcloneShallow(boolean spacingBefore)Creates a shallow clone of the Paragraph.PdfObjectgetAccessibleAttribute(PdfName key)Get the attribute of accessible element (everything inAdictionary +Lang,Alt,ActualText,E).java.util.HashMap<PdfName,PdfObject>getAccessibleAttributes()Gets all the properties of accessible element.intgetAlignment()Gets the alignment of this paragraph.floatgetExtraParagraphSpace()Getter for property extraParagraphSpace.floatgetFirstLineIndent()Getter for property firstLineIndent.AccessibleElementIdgetId()floatgetIndentationLeft()Gets the indentation on the left side.floatgetIndentationRight()Gets the indentation on the right side.booleangetKeepTogether()Checks if this paragraph has to be kept together on one page.floatgetPaddingTop()PdfNamegetRole()Gets the role of the accessible element.floatgetSpacingAfter()Gets the spacing after.floatgetSpacingBefore()Gets the spacing before.booleanisInline()protected voidpopulateProperties(Paragraph copy, boolean spacingBefore)voidsetAccessibleAttribute(PdfName key, PdfObject value)Set the attribute of accessible element (everything inAdictionary +Lang,Alt,ActualText,E).voidsetAlignment(int alignment)Sets the alignment of this paragraph.voidsetExtraParagraphSpace(float extraParagraphSpace)Setter for property extraParagraphSpace.voidsetFirstLineIndent(float firstLineIndent)Setter for property firstLineIndent.voidsetId(AccessibleElementId id)voidsetIndentationLeft(float indentation)Sets the indentation on the left side.voidsetIndentationRight(float indentation)Sets the indentation on the right side.voidsetKeepTogether(boolean keeptogether)Indicates that the paragraph has to be kept together on one page.voidsetPaddingTop(float paddingTop)voidsetRole(PdfName role)Sets the role of the accessiblee element.voidsetSpacingAfter(float spacing)Sets the spacing after.voidsetSpacingBefore(float spacing)Sets the spacing before.floatspacingAfter()Deprecated.As of iText 2.1.5, replaced bygetSpacingAfter(), scheduled for removal at 2.3.0floatspacingBefore()Deprecated.As of iText 2.1.5, replaced bygetSpacingBefore(), scheduled for removal at 2.3.0inttype()Gets the type of the text element.-
Methods inherited from class com.itextpdf.text.Phrase
add, add, addAll, addChunk, addSpecial, getChunks, getContent, getFont, getHyphenation, getInstance, getInstance, getInstance, getLeading, getMultipliedLeading, getTabSettings, getTotalLeading, hasLeading, isContent, isEmpty, isNestable, process, setFont, setHyphenation, setLeading, setLeading, setMultipliedLeading, setTabSettings, trim
-
Methods inherited from class java.util.ArrayList
addAll, clear, clone, contains, ensureCapacity, equals, forEach, get, hashCode, indexOf, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeIf, removeRange, replaceAll, retainAll, set, size, sort, spliterator, subList, toArray, toArray, trimToSize
-
-
-
-
Field Detail
-
serialVersionUID
private static final long serialVersionUID
- See Also:
- Constant Field Values
-
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.
-
firstLineIndent
private float firstLineIndent
Holds value of property firstLineIndent.
-
spacingBefore
protected float spacingBefore
The spacing before the paragraph.
-
spacingAfter
protected float spacingAfter
The spacing after the paragraph.
-
extraParagraphSpace
private float extraParagraphSpace
Holds value of property extraParagraphSpace.
-
keeptogether
protected boolean keeptogether
Does the paragraph has to be kept together on 1 page.
-
paddingTop
protected float paddingTop
-
role
protected PdfName role
-
id
protected AccessibleElementId id
-
-
Constructor Detail
-
Paragraph
public Paragraph()
Constructs aParagraph.
-
Paragraph
public Paragraph(float leading)
Constructs aParagraphwith a certain leading.- Parameters:
leading- the leading
-
Paragraph
public Paragraph(Chunk chunk)
Constructs aParagraphwith a certainChunk.- Parameters:
chunk- aChunk
-
Paragraph
public Paragraph(float leading, Chunk chunk)Constructs aParagraphwith a certainChunkand a certain leading.- Parameters:
leading- the leadingchunk- aChunk
-
Paragraph
public Paragraph(java.lang.String string)
Constructs aParagraphwith a certainString.- Parameters:
string- aString
-
Paragraph
public Paragraph(java.lang.String string, Font font)Constructs aParagraphwith a certainStringand a certainFont.- Parameters:
string- aStringfont- aFont
-
Paragraph
public Paragraph(float leading, java.lang.String string)Constructs aParagraphwith a certainStringand a certain leading.- Parameters:
leading- the leadingstring- aString
-
Paragraph
public Paragraph(float leading, java.lang.String string, Font font)Constructs aParagraphwith a certain leading,StringandFont.- Parameters:
leading- the leadingstring- aStringfont- aFont
-
Paragraph
public Paragraph(Phrase phrase)
Constructs aParagraphwith a certainPhrase.- Parameters:
phrase- aPhrase
-
-
Method Detail
-
cloneShallow
public Paragraph cloneShallow(boolean spacingBefore)
Creates a shallow clone of the Paragraph.- Returns:
-
populateProperties
protected void populateProperties(Paragraph copy, boolean spacingBefore)
-
breakUp
public java.util.List<Element> breakUp()
Breaks this Paragraph up in different parts, separating paragraphs, lists and tables from each other.- Returns:
-
type
public int type()
Gets the type of the text element.
-
add
public boolean add(Element o)
Adds anElementto theParagraph.
-
setAlignment
public void setAlignment(int alignment)
Sets the alignment of this paragraph.- Parameters:
alignment- the new alignment
-
setIndentationLeft
public void setIndentationLeft(float indentation)
Description copied from interface:IndentableSets the indentation on the left side.- Specified by:
setIndentationLeftin interfaceIndentable- Parameters:
indentation- the new indentation
-
setIndentationRight
public void setIndentationRight(float indentation)
Description copied from interface:IndentableSets the indentation on the right side.- Specified by:
setIndentationRightin interfaceIndentable- Parameters:
indentation- the new indentation
-
setFirstLineIndent
public void setFirstLineIndent(float firstLineIndent)
Setter for property firstLineIndent.- Parameters:
firstLineIndent- New value of property firstLineIndent.
-
setSpacingBefore
public void setSpacingBefore(float spacing)
Description copied from interface:SpaceableSets the spacing before.- Specified by:
setSpacingBeforein interfaceSpaceable- Parameters:
spacing- the new spacing
-
setSpacingAfter
public void setSpacingAfter(float spacing)
Description copied from interface:SpaceableSets the spacing after.- Specified by:
setSpacingAfterin interfaceSpaceable- Parameters:
spacing- the new spacing
-
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.
-
getAlignment
public int getAlignment()
Gets the alignment of this paragraph.- Returns:
- alignment
-
getIndentationLeft
public float getIndentationLeft()
Description copied from interface:IndentableGets the indentation on the left side.- Specified by:
getIndentationLeftin interfaceIndentable- Returns:
- the indentation
-
getIndentationRight
public float getIndentationRight()
Description copied from interface:IndentableGets the indentation on the right side.- Specified by:
getIndentationRightin interfaceIndentable- Returns:
- the indentation
-
getFirstLineIndent
public float getFirstLineIndent()
Getter for property firstLineIndent.- Returns:
- Value of property firstLineIndent.
-
getSpacingBefore
public float getSpacingBefore()
Description copied from interface:SpaceableGets the spacing before.- Specified by:
getSpacingBeforein interfaceSpaceable- Returns:
- the spacing
-
getSpacingAfter
public float getSpacingAfter()
Description copied from interface:SpaceableGets the spacing after.- Specified by:
getSpacingAfterin interfaceSpaceable- Returns:
- the spacing
-
getExtraParagraphSpace
public float getExtraParagraphSpace()
Getter for property extraParagraphSpace.- Returns:
- Value of property extraParagraphSpace.
-
setExtraParagraphSpace
public void setExtraParagraphSpace(float extraParagraphSpace)
Setter for property extraParagraphSpace.- Parameters:
extraParagraphSpace- New value of property extraParagraphSpace.
-
spacingBefore
@Deprecated public float spacingBefore()
Deprecated.As of iText 2.1.5, replaced bygetSpacingBefore(), scheduled for removal at 2.3.0Gets the spacing before this paragraph.- Returns:
- the spacing
-
spacingAfter
@Deprecated public float spacingAfter()
Deprecated.As of iText 2.1.5, replaced bygetSpacingAfter(), scheduled for removal at 2.3.0Gets the spacing after this paragraph.- Returns:
- the spacing
-
getAccessibleAttribute
public PdfObject getAccessibleAttribute(PdfName key)
Description copied from interface:IAccessibleElementGet the attribute of accessible element (everything inAdictionary +Lang,Alt,ActualText,E).- Specified by:
getAccessibleAttributein interfaceIAccessibleElement- Returns:
-
setAccessibleAttribute
public void setAccessibleAttribute(PdfName key, PdfObject value)
Description copied from interface:IAccessibleElementSet the attribute of accessible element (everything inAdictionary +Lang,Alt,ActualText,E).- Specified by:
setAccessibleAttributein interfaceIAccessibleElement
-
getAccessibleAttributes
public java.util.HashMap<PdfName,PdfObject> getAccessibleAttributes()
Description copied from interface:IAccessibleElementGets all the properties of accessible element.- Specified by:
getAccessibleAttributesin interfaceIAccessibleElement- Returns:
-
getRole
public PdfName getRole()
Description copied from interface:IAccessibleElementGets the role of the accessible element.- Specified by:
getRolein interfaceIAccessibleElement- Returns:
-
setRole
public void setRole(PdfName role)
Description copied from interface:IAccessibleElementSets the role of the accessiblee element. Set role tonullif you don't want to tag this element. Note that all child elements won't also be tagged.- Specified by:
setRolein interfaceIAccessibleElement
-
getId
public AccessibleElementId getId()
- Specified by:
getIdin interfaceIAccessibleElement
-
setId
public void setId(AccessibleElementId id)
- Specified by:
setIdin interfaceIAccessibleElement
-
isInline
public boolean isInline()
- Specified by:
isInlinein interfaceIAccessibleElement
-
getPaddingTop
public float getPaddingTop()
- Specified by:
getPaddingTopin interfaceSpaceable
-
setPaddingTop
public void setPaddingTop(float paddingTop)
- Specified by:
setPaddingTopin interfaceSpaceable
-
-