Class FDFAnnotation

java.lang.Object
org.apache.pdfbox.pdmodel.fdf.FDFAnnotation
All Implemented Interfaces:
COSObjectable
Direct Known Subclasses:
FDFAnnotationCaret, FDFAnnotationCircle, FDFAnnotationFileAttachment, FDFAnnotationFreeText, FDFAnnotationInk, FDFAnnotationLine, FDFAnnotationLink, FDFAnnotationPolygon, FDFAnnotationPolyline, FDFAnnotationSound, FDFAnnotationSquare, FDFAnnotationStamp, FDFAnnotationText, FDFAnnotationTextMarkup

public abstract class FDFAnnotation extends Object implements COSObjectable
This represents an FDF annotation that is part of the FDF document.
  • Field Details

    • LOG

      private static final org.apache.commons.logging.Log LOG
    • FLAG_INVISIBLE

      private static final int FLAG_INVISIBLE
      An annotation flag.
      See Also:
    • FLAG_HIDDEN

      private static final int FLAG_HIDDEN
      An annotation flag.
      See Also:
    • FLAG_PRINTED

      private static final int FLAG_PRINTED
      An annotation flag.
      See Also:
    • FLAG_NO_ZOOM

      private static final int FLAG_NO_ZOOM
      An annotation flag.
      See Also:
    • FLAG_NO_ROTATE

      private static final int FLAG_NO_ROTATE
      An annotation flag.
      See Also:
    • FLAG_NO_VIEW

      private static final int FLAG_NO_VIEW
      An annotation flag.
      See Also:
    • FLAG_READ_ONLY

      private static final int FLAG_READ_ONLY
      An annotation flag.
      See Also:
    • FLAG_LOCKED

      private static final int FLAG_LOCKED
      An annotation flag.
      See Also:
    • FLAG_TOGGLE_NO_VIEW

      private static final int FLAG_TOGGLE_NO_VIEW
      An annotation flag.
      See Also:
    • FLAG_LOCKED_CONTENTS

      private static final int FLAG_LOCKED_CONTENTS
      An annotation flag.
      See Also:
    • annot

      protected COSDictionary annot
      Annotation dictionary.
  • Constructor Details

    • FDFAnnotation

      public FDFAnnotation()
      Default constructor.
    • FDFAnnotation

      public FDFAnnotation(COSDictionary a)
      Constructor.
      Parameters:
      a - The FDF annotation.
    • FDFAnnotation

      public FDFAnnotation(Element element) throws IOException
      Constructor.
      Parameters:
      element - An XFDF element.
      Throws:
      IOException - If there is an error extracting data from the element.
  • Method Details

    • create

      public static FDFAnnotation create(COSDictionary fdfDic) throws IOException
      Create the correct FDFAnnotation.
      Parameters:
      fdfDic - The FDF dictionary.
      Returns:
      A newly created FDFAnnotation
      Throws:
      IOException - If there is an error accessing the FDF information.
    • getCOSObject

      public COSDictionary getCOSObject()
      Convert this standard java object to a COS object.
      Specified by:
      getCOSObject in interface COSObjectable
      Returns:
      The cos object that matches this Java object.
    • getPage

      public Integer getPage()
      This will get the page number or null if it does not exist.
      Returns:
      The page number.
    • setPage

      public final void setPage(int page)
      This will set the page.
      Parameters:
      page - The page number.
    • getColor

      public Color getColor()
      Get the annotation color.
      Returns:
      The annotation color, or null if there is none.
    • setColor

      public final void setColor(Color c)
      Set the annotation color.
      Parameters:
      c - The annotation color.
    • getDate

      public String getDate()
      Modification date.
      Returns:
      The date as a string.
    • setDate

      public final void setDate(String date)
      The annotation modification date.
      Parameters:
      date - The date to store in the FDF annotation.
    • isInvisible

      public boolean isInvisible()
      Get the invisible flag.
      Returns:
      The invisible flag.
    • setInvisible

      public final void setInvisible(boolean invisible)
      Set the invisible flag.
      Parameters:
      invisible - The new invisible flag.
    • isHidden

      public boolean isHidden()
      Get the hidden flag.
      Returns:
      The hidden flag.
    • setHidden

      public final void setHidden(boolean hidden)
      Set the hidden flag.
      Parameters:
      hidden - The new hidden flag.
    • isPrinted

      public boolean isPrinted()
      Get the printed flag.
      Returns:
      The printed flag.
    • setPrinted

      public final void setPrinted(boolean printed)
      Set the printed flag.
      Parameters:
      printed - The new printed flag.
    • isNoZoom

      public boolean isNoZoom()
      Get the noZoom flag.
      Returns:
      The noZoom flag.
    • setNoZoom

      public final void setNoZoom(boolean noZoom)
      Set the noZoom flag.
      Parameters:
      noZoom - The new noZoom flag.
    • isNoRotate

      public boolean isNoRotate()
      Get the noRotate flag.
      Returns:
      The noRotate flag.
    • setNoRotate

      public final void setNoRotate(boolean noRotate)
      Set the noRotate flag.
      Parameters:
      noRotate - The new noRotate flag.
    • isNoView

      public boolean isNoView()
      Get the noView flag.
      Returns:
      The noView flag.
    • setNoView

      public final void setNoView(boolean noView)
      Set the noView flag.
      Parameters:
      noView - The new noView flag.
    • isReadOnly

      public boolean isReadOnly()
      Get the readOnly flag.
      Returns:
      The readOnly flag.
    • setReadOnly

      public final void setReadOnly(boolean readOnly)
      Set the readOnly flag.
      Parameters:
      readOnly - The new readOnly flag.
    • isLocked

      public boolean isLocked()
      Get the locked flag.
      Returns:
      The locked flag.
    • setLocked

      public final void setLocked(boolean locked)
      Set the locked flag.
      Parameters:
      locked - The new locked flag.
    • isToggleNoView

      public boolean isToggleNoView()
      Get the toggleNoView flag.
      Returns:
      The toggleNoView flag.
    • setToggleNoView

      public final void setToggleNoView(boolean toggleNoView)
      Set the toggleNoView flag.
      Parameters:
      toggleNoView - The new toggleNoView flag.
    • isLockedContents

      public boolean isLockedContents()
      Get the LockedContents flag.
      Returns:
      The LockedContents flag.
    • setLockedContents

      public void setLockedContents(boolean lockedContents)
      Set the LockedContents flag.
      Parameters:
      lockedContents - The new LockedContents flag.
    • setName

      public final void setName(String name)
      Set a unique name for an annotation.
      Parameters:
      name - The unique annotation name.
    • getName

      public String getName()
      Get the annotation name.
      Returns:
      The unique name of the annotation.
    • setRectangle

      public final void setRectangle(PDRectangle rectangle)
      Set the rectangle associated with this annotation.
      Parameters:
      rectangle - The annotation rectangle.
    • getRectangle

      public PDRectangle getRectangle()
      The rectangle associated with this annotation.
      Returns:
      The annotation rectangle.
    • setContents

      public final void setContents(String contents)
      Set the contents, or a description, for an annotation.
      Parameters:
      contents - The annotation contents, or a description.
    • getContents

      public String getContents()
      Get the text, or a description, of the annotation.
      Returns:
      The text, or a description, of the annotation.
    • setTitle

      public final void setTitle(String title)
      Set a unique title for an annotation.
      Parameters:
      title - The annotation title.
    • getTitle

      public String getTitle()
      Get the annotation title.
      Returns:
      The title of the annotation.
    • getCreationDate

      public Calendar getCreationDate() throws IOException
      The annotation create date.
      Returns:
      The date of the creation of the annotation date
      Throws:
      IOException - If there is an error converting the string to a Calendar object.
    • setCreationDate

      public final void setCreationDate(Calendar date)
      Set the creation date.
      Parameters:
      date - The date the annotation was created.
    • setOpacity

      public final void setOpacity(float opacity)
      Set the annotation opacity.
      Parameters:
      opacity - The new opacity value.
    • getOpacity

      public float getOpacity()
      Get the opacity value.
      Returns:
      The opacity of the annotation.
    • setSubject

      public final void setSubject(String subject)
      A short description of the annotation.
      Parameters:
      subject - The annotation subject.
    • getSubject

      public String getSubject()
      Get the description of the annotation.
      Returns:
      The subject of the annotation.
    • setIntent

      public final void setIntent(String intent)
      The intent of the annotation.
      Parameters:
      intent - The annotation's intent.
    • getIntent

      public String getIntent()
      Get the intent of the annotation.
      Returns:
      The intent of the annotation.
    • getRichContents

      public String getRichContents()
      This will retrieve the rich text stream which is displayed in the popup window.
      Returns:
      the rich text stream.
    • setRichContents

      public final void setRichContents(String rc)
      This will set the rich text stream which is displayed in the popup window.
      Parameters:
      rc - the rich text stream.
    • setBorderStyle

      public final void setBorderStyle(PDBorderStyleDictionary bs)
      This will set the border style dictionary, specifying the width and dash pattern used in drawing the annotation.
      Parameters:
      bs - the border style dictionary to set.
    • getBorderStyle

      public PDBorderStyleDictionary getBorderStyle()
      This will retrieve the border style dictionary, specifying the width and dash pattern used in drawing the annotation.
      Returns:
      the border style dictionary.
    • setBorderEffect

      public final void setBorderEffect(PDBorderEffectDictionary be)
      This will set the border effect dictionary, describing the effect applied to the border described by the BS entry.
      Parameters:
      be - the border effect dictionary to set.
    • getBorderEffect

      public PDBorderEffectDictionary getBorderEffect()
      This will retrieve the border style dictionary, describing the effect applied to the border described by the BS entry.
      Returns:
      the border effect dictionary.
    • getStringOrStream

      protected final String getStringOrStream(COSBase base)
      Get a text or text stream. Some dictionary entries allow either a text or a text stream.
      Parameters:
      base - the potential text or text stream
      Returns:
      the text stream
    • richContentsToString

      private String richContentsToString(Node node, boolean root)