Package com.itextpdf.layout.element

Class Paragraph

java.lang.Object

com.itextpdf.commons.actions.sequence.AbstractIdentifiableElement

com.itextpdf.layout.ElementPropertyContainer

com.itextpdf.layout.element.AbstractElement

com.itextpdf.layout.element.BlockElement

com.itextpdf.layout.element.AbstractParagraph<Paragraph>

com.itextpdf.layout.element.Paragraph

All Implemented Interfaces:

IAbstractElement, IBlockElement, IElement, IPropertyContainer, IAccessibleElement

Direct Known Subclasses:

AnonymousInlineBox

       public class Paragraph extends AbstractParagraph<Paragraph>
      

A layout element that represents a self-contained block of textual and graphical information. It is a BlockElement which essentially acts as a container for leaf elements.

Field Summary

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

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	Description
Paragraph()	Creates a new Paragraph instance.
Paragraph(Text text)	Creates a Paragraph, initialized with a piece of text.
Paragraph(String text)	Creates a Paragraph, initialized with a piece of text.

Method Summary

Modifier and Type	Method	Description
Paragraph	add(IBlockElement element)	Adds an element to this Paragraph.
Paragraph	add(ILeafElement element)	Adds a element to this Paragraph.
Paragraph	add(FootnoteAnchor footnoteAnchor)	Adds the FootnoteAnchor element to this Paragraph.
Paragraph	add(String text)	Adds a piece of text to this Paragraph.
ILeafElement> Paragraph	addAll(List elements)	Adds a List of layout elements to this Paragraph.
Paragraph	addTabStops(TabStop... tabStops)	Adds an unspecified amount of tabstop elements as properties to this Paragraph.
Paragraph	addTabStops(List<TabStop> tabStops)	Adds a List of tabstop elements as properties to this Paragraph.
protected IRenderer	makeNewRenderer()	Creates a new renderer instance.
Paragraph	removeTabStop(float tabStopPosition)	Removes a tabstop position from the Paragraph, if it is present in the Property.TAB_STOPS property.
Paragraph	setFirstLineIndent(float indent)	Sets the indent value for the first line of the Paragraph.
Paragraph	setFixedLeading(float leading)	Sets the leading value, using the Leading.FIXED strategy.
Paragraph	setMultipliedLeading(float leading)	Sets the leading value, using the Leading.MULTIPLIED strategy.
Paragraph	setOrphansControl(ParagraphOrphansControl orphansControl)	Sets orphans restriction on a Paragraph.
Paragraph	setWidowsControl(ParagraphWidowsControl widowsControl)	Sets widows restriction on a Paragraph.

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

add, add, addTabStopsAsProperty, getAccessibilityProperties, getDefaultProperty

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

getHeight, getMarginBottom, getMarginLeft, getMarginRight, getMarginTop, getPaddingBottom, getPaddingLeft, getPaddingRight, getPaddingTop, getWidth, isKeepTogether, isKeepWithNext, setHeight, setHeight, setKeepTogether, setKeepWithNext, setMargin, setMarginBottom, setMarginLeft, setMarginRight, setMargins, setMarginTop, setMaxHeight, setMaxHeight, setMaxWidth, setMaxWidth, setMinHeight, setMinHeight, setMinWidth, setMinWidth, setNeutralRole, setPadding, setPaddingBottom, setPaddingLeft, setPaddingRight, setPaddings, setPaddingTop, setRotationAngle, setRotationAngle, setSpacingRatio, setTransform, setVerticalAlignment, setWidth, setWidth

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

addStyle, addStyleIfAbsent, createRendererSubTree, getChildren, getProperty, getRenderer, getStyles, hasProperty, isEmpty, setAction, setNextRenderer, setPageNumber

Methods inherited from class com.itextpdf.layout.ElementPropertyContainer

deleteOwnProperty, getLineCapStyle, getLineJoinStyle, getMiterLimit, getOwnProperties, getOwnProperty, getSplitCharacters, getStrokeColor, getStrokeWidth, getTextRenderingMode, getTransparentStrokeColor, hasOwnProperty, setBackgroundColor, setBackgroundColor, setBackgroundColor, setBackgroundColor, setBackgroundImage, setBackgroundImage, setBaseDirection, setBorder, setBorderBottom, setBorderBottomLeftRadius, setBorderBottomRightRadius, setBorderLeft, setBorderRadius, setBorderRight, setBorderTop, setBorderTopLeftRadius, setBorderTopRightRadius, setCharacterSpacing, setDashPattern, setDestination, setFixedPosition, setFixedPosition, setFixedPosition, setFixedPosition, setFont, setFontColor, setFontColor, setFontColor, setFontFamily, setFontFamily, setFontKerning, setFontScript, setFontSize, setHorizontalAlignment, setHyphenation, setLineCapStyle, setLineJoinStyle, setLineThrough, setMiterLimit, setOpacity, setProperty, setRelativePosition, setSplitCharacters, setStrokeColor, setStrokeColor, setStrokeColor, setStrokeWidth, setTextAlignment, setTextRenderingMode, setUnderline, setUnderline, setUnderline, setUnderline, setUnderline, setWordSpacing, simulateBold, simulateItalic

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.itextpdf.layout.element.IAbstractElement

getChildren

Methods inherited from interface com.itextpdf.layout.element.IElement

createRendererSubTree, getRenderer, setNextRenderer

Methods inherited from interface com.itextpdf.layout.IPropertyContainer

deleteOwnProperty, getOwnProperty, getProperty, hasOwnProperty, hasProperty, setProperty

Constructor Details

Paragraph

             public Paragraph()
            

Creates a new Paragraph instance.

Paragraph

             public Paragraph
             (String text)
            

Creates a Paragraph, initialized with a piece of text.

Parameters:

text - the initial textual content, as a String

Paragraph

             public Paragraph
             (Text text)
            

Creates a Paragraph, initialized with a piece of text.

Parameters:

text - the initial textual content, as a Text

Method Details

add

             public Paragraph add
             (String text)
            

Adds a piece of text to this Paragraph.

Overrides:

add in class AbstractParagraph<Paragraph>

Parameters:

text - the content to be added, as a String

Returns:

this Paragraph

add

             public Paragraph add
             (ILeafElement element)
            

Adds a element to this Paragraph.

Overrides:

add in class AbstractParagraph<Paragraph>

Parameters:

element - the content to be added, any ILeafElement

Returns:

this Paragraph

add

             public Paragraph add
             (IBlockElement element)
            

Adds an element to this Paragraph.

Parameters:

element - the content to be added, any IBlockElement

Returns:

this Paragraph

add

             public Paragraph add
             (FootnoteAnchor footnoteAnchor)
            

Adds the FootnoteAnchor element to this Paragraph.

Parameters:

footnoteAnchor - the footnote anchor to be added

Returns:

this same Paragraph instance

addAll

             public ILeafElement> Paragraph addAll
             (List elements)
            

Adds a List of layout elements to this Paragraph.

Overrides:

addAll in class AbstractParagraph<Paragraph>

Type Parameters:

T2 - any ILeafElement

Parameters:

elements - the content to be added

Returns:

this Paragraph

addTabStops

             public Paragraph addTabStops
             (TabStop... tabStops)
            

Adds an unspecified amount of tabstop elements as properties to this Paragraph.

Parameters:

tabStops - the tabstop(s) to be added as properties

Returns:

this Paragraph

See Also:

• TabStop

addTabStops

             public Paragraph addTabStops
             (List<TabStop> tabStops)
            

Adds a List of tabstop elements as properties to this Paragraph.

Parameters:

tabStops - the list of TabStops to be added as properties

Returns:

this Paragraph

See Also:

• TabStop

removeTabStop

             public Paragraph removeTabStop
             (float tabStopPosition)
            

Removes a tabstop position from the Paragraph, if it is present in the Property.TAB_STOPS property.

Parameters:

tabStopPosition - the TabStop position to be removed.

Returns:

this Paragraph

See Also:

• TabStop

setFirstLineIndent

             public Paragraph setFirstLineIndent
             (float indent)
            

Sets the indent value for the first line of the Paragraph.

Overrides:

setFirstLineIndent in class AbstractParagraph<Paragraph>

Parameters:

indent - the indent value that must be applied to the first line of the Paragraph, as a float

Returns:

this Paragraph

setOrphansControl

             public Paragraph setOrphansControl
             (ParagraphOrphansControl orphansControl)
            

Sets orphans restriction on a Paragraph.

Overrides:

setOrphansControl in class AbstractParagraph<Paragraph>

Parameters:

orphansControl - an instance of ParagraphOrphansControl

Returns:

this Paragraph instance

setWidowsControl

             public Paragraph setWidowsControl
             (ParagraphWidowsControl widowsControl)
            

Sets widows restriction on a Paragraph.

Overrides:

setWidowsControl in class AbstractParagraph<Paragraph>

Parameters:

widowsControl - an instance of ParagraphWidowsControl

Returns:

this Paragraph instance

setFixedLeading

             public Paragraph setFixedLeading
             (float leading)
            

Sets the leading value, using the Leading.FIXED strategy.

If for the element RenderingMode.HTML_MODE is enabled, than Property.LINE_HEIGHT property will be set instead of default layout Property.LEADING.

Parameters:

leading - the new leading value

Returns:

this Paragraph

See Also:

• Leading
• LineHeight

setMultipliedLeading

             public Paragraph setMultipliedLeading
             (float leading)
            

Sets the leading value, using the Leading.MULTIPLIED strategy.

If for the element RenderingMode.HTML_MODE is enabled, than Property.LINE_HEIGHT property will be set instead of default layout Property.LEADING.

Parameters:

leading - the new leading value

Returns:

this Paragraph

See Also:

• Leading
• LineHeight

makeNewRenderer

             protected IRenderer makeNewRenderer()
            

Creates a new renderer instance.

Specified by:

makeNewRenderer in class AbstractElement<Paragraph>

Returns:

new IRenderer