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

        private int alignment
        The alignment of the text.
      • multipliedLeading

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

        private float indentationLeft
        The indentation of this paragraph on the left side.
      • indentationRight

        private float indentationRight
        The indentation of this paragraph on the right side.
      • firstLineIndent

        private float firstLineIndent
        Holds value of property firstLineIndent.
      • spacingBefore

        private float spacingBefore
        The spacing before the paragraph.
      • spacingAfter

        private float spacingAfter
        The spacing after the paragraph.
      • extraParagraphSpace

        private float extraParagraphSpace
        Holds value of property extraParagraphSpace.
      • keeptogether

        private boolean keeptogether
        Does the paragraph has to be kept together on 1 page.
    • Constructor Detail

      • Paragraph

        public Paragraph()
        Constructs a Paragraph.
      • Paragraph

        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​(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​(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

        private 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

        @Deprecated
        private 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

        @Deprecated
        private 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