Module itextpdf
Package com.itextpdf.text

Class Paragraph

  • All Implemented Interfaces:
    Element, TextElementArray, java.io.Serializable, java.lang.Cloneable, java.lang.Iterable, java.util.Collection, java.util.List, java.util.RandomAccess
    Direct Known Subclasses:
    ListItem
    public class Paragraph
extends Phrase
    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:

    • the indentation
    • the alignment of the text
    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 Detail

      • alignment

        protected int alignment
        The alignment of the text.

      • multipliedLeading

        protected float multipliedLeading
        The text leading that is multiplied by the biggest font size in the line.

      • 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.

      • spacingBefore

        protected float spacingBefore
        The spacing before the paragraph.

      • spacingAfter

        protected float spacingAfter
        The spacing after the paragraph.

      • 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​(java.lang.String string)
        Constructs a Paragraph with a certain String.
        Parameters:
        string - a String

      • Paragraph

        public Paragraph​(java.lang.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,
                 java.lang.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,
                 java.lang.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

    • 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​(java.lang.Object o)
        Adds an Object to the Paragraph.
        Specified by:
        add in interface java.util.Collection
        Specified by:
        add in interface java.util.List
        Specified by:
        add in interface TextElementArray
        Overrides:
        add in class Phrase
        Parameters:
        o - object the object to add.
        Returns:
        true is adding the object succeeded

      • setAlignment

        public void setAlignment​(int alignment)
        Sets the alignment of this paragraph.
        Parameters:
        alignment - the new alignment

      • setAlignment

        public void setAlignment​(java.lang.String alignment)
        Sets the alignment of this paragraph.
        Parameters:
        alignment - the new alignment as a String

      • setLeading

        public void setLeading​(float fixedLeading)
        Description copied from class: Phrase
        Sets the leading of this phrase.
        Overrides:
        setLeading in class Phrase
        Parameters:
        fixedLeading - the new leading
        See Also:
        Phrase.setLeading(float)

      • setMultipliedLeading

        public void setMultipliedLeading​(float multipliedLeading)
        Sets the variable leading. The resultant leading will be multipliedLeading*maxFontSize where maxFontSize is the size of the biggest font in the line.
        Parameters:
        multipliedLeading - the variable leading

      • setLeading

        public void setLeading​(float fixedLeading,
                       float multipliedLeading)
        Sets the leading fixed and variable. The resultant leading will be fixedLeading+multipliedLeading*maxFontSize where maxFontSize is the size of the biggest font in the line.
        Parameters:
        fixedLeading - the fixed leading
        multipliedLeading - the variable leading

      • 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

      • setFirstLineIndent

        public void setFirstLineIndent​(float firstLineIndent)
        Setter for property firstLineIndent.
        Parameters:
        firstLineIndent - New value of property firstLineIndent.

      • setSpacingBefore

        public void setSpacingBefore​(float spacing)
        Sets the spacing before this paragraph.
        Parameters:
        spacing - the new spacing

      • setSpacingAfter

        public void setSpacingAfter​(float spacing)
        Sets the spacing after this paragraph.
        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

      • getMultipliedLeading

        public float getMultipliedLeading()
        Gets the variable leading
        Returns:
        the leading

      • getTotalLeading

        public float getTotalLeading()
        Gets the total leading. This method is based on the assumption that the font of the Paragraph is the font of all the elements that make part of the paragraph. This isn't necessarily true.
        Returns:
        the total leading (fixed and multiplied)

      • getIndentationLeft

        public float getIndentationLeft()
        Gets the indentation of this paragraph on the left side.
        Returns:
        the indentation

      • getIndentationRight

        public float getIndentationRight()
        Gets the indentation of this paragraph on the right side.
        Returns:
        the indentation

      • getFirstLineIndent

        public float getFirstLineIndent()
        Getter for property firstLineIndent.
        Returns:
        Value of property firstLineIndent.

      • getSpacingBefore

        public float getSpacingBefore()
        Gets the spacing before this paragraph.
        Returns:
        the spacing
        Since:
        2.1.5

      • getSpacingAfter

        public float getSpacingAfter()
        Gets the spacing after this paragraph.
        Returns:
        the spacing
        Since:
        2.1.5

      • 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

        public float spacingBefore()
        Deprecated.
        As of iText 2.1.5, replaced by getSpacingBefore(), scheduled for removal at 2.3.0
        Gets the spacing before this paragraph.
        Returns:
        the spacing

      • spacingAfter

        public float spacingAfter()
        Deprecated.
        As of iText 2.1.5, replaced by getSpacingAfter(), scheduled for removal at 2.3.0
        Gets the spacing after this paragraph.
        Returns:
        the spacing