Class PdfOutline


public class PdfOutline extends PdfDictionary
PdfOutline is an object that represents a PDF outline entry.

An outline allows a user to access views of a document by name.
This object is described in the 'Portable Document Format Reference Manual version 1.3' section 6.7 (page 104-106)

See Also:
  • Field Details

    • kids

      protected List<PdfOutline> kids
    • writer

      protected PdfWriter writer
    • reference

      private PdfIndirectReference reference
      the PdfIndirectReference of this object
    • count

      private int count
      value of the Count-key
    • parent

      private PdfOutline parent
      value of the Parent-key
    • destination

      private PdfDestination destination
      value of the Destination-key
    • action

      private PdfAction action
      The PdfAction for this outline.
    • tag

      private String tag
      Holds value of property tag.
    • open

      private boolean open
      Holds value of property open.
    • color

      private Color color
      Holds value of property color.
    • style

      private int style
      Holds value of property style.
  • Constructor Details

    • PdfOutline

      PdfOutline(PdfWriter writer)
      Constructs a PdfOutline.

      This is the constructor for the outlines object.

      Parameters:
      writer - The PdfWriter you are adding the outline to
    • PdfOutline

      public PdfOutline(PdfOutline parent, PdfAction action, String title)
      Constructs a PdfOutline.

      This is the constructor for an outline entry. The open mode is true.

      Parameters:
      parent - the parent of this outline item
      action - the PdfAction for this outline item
      title - the title of this outline item
    • PdfOutline

      public PdfOutline(PdfOutline parent, PdfAction action, String title, boolean open)
      Constructs a PdfOutline.

      This is the constructor for an outline entry.

      Parameters:
      parent - the parent of this outline item
      action - the PdfAction for this outline item
      title - the title of this outline item
      open - true if the children are visible
    • PdfOutline

      public PdfOutline(PdfOutline parent, PdfDestination destination, String title)
      Constructs a PdfOutline.

      This is the constructor for an outline entry. The open mode is true.

      Parameters:
      parent - the parent of this outline item
      destination - the destination for this outline item
      title - the title of this outline item
    • PdfOutline

      public PdfOutline(PdfOutline parent, PdfDestination destination, String title, boolean open)
      Constructs a PdfOutline.

      This is the constructor for an outline entry.

      Parameters:
      parent - the parent of this outline item
      destination - the destination for this outline item
      title - the title of this outline item
      open - true if the children are visible
    • PdfOutline

      public PdfOutline(PdfOutline parent, PdfAction action, PdfString title)
      Constructs a PdfOutline.

      This is the constructor for an outline entry. The open mode is true.

      Parameters:
      parent - the parent of this outline item
      action - the PdfAction for this outline item
      title - the title of this outline item
    • PdfOutline

      public PdfOutline(PdfOutline parent, PdfAction action, PdfString title, boolean open)
      Constructs a PdfOutline.

      This is the constructor for an outline entry.

      Parameters:
      parent - the parent of this outline item
      action - the PdfAction for this outline item
      title - the title of this outline item
      open - true if the children are visible
    • PdfOutline

      public PdfOutline(PdfOutline parent, PdfDestination destination, PdfString title)
      Constructs a PdfOutline.

      This is the constructor for an outline entry. The open mode is true.

      Parameters:
      parent - the parent of this outline item
      destination - the destination for this outline item
      title - the title of this outline item
    • PdfOutline

      public PdfOutline(PdfOutline parent, PdfDestination destination, PdfString title, boolean open)
      Constructs a PdfOutline.

      This is the constructor for an outline entry.

      Parameters:
      parent - the parent of this outline item
      destination - the destination for this outline item
      title - the title of this outline item
      open - true if the children are visible
    • PdfOutline

      public PdfOutline(PdfOutline parent, PdfAction action, Paragraph title)
      Constructs a PdfOutline.

      This is the constructor for an outline entry. The open mode is true.

      Parameters:
      parent - the parent of this outline item
      action - the PdfAction for this outline item
      title - the title of this outline item
    • PdfOutline

      public PdfOutline(PdfOutline parent, PdfAction action, Paragraph title, boolean open)
      Constructs a PdfOutline.

      This is the constructor for an outline entry.

      Parameters:
      parent - the parent of this outline item
      action - the PdfAction for this outline item
      title - the title of this outline item
      open - true if the children are visible
    • PdfOutline

      public PdfOutline(PdfOutline parent, PdfDestination destination, Paragraph title)
      Constructs a PdfOutline.

      This is the constructor for an outline entry. The open mode is true.

      Parameters:
      parent - the parent of this outline item
      destination - the destination for this outline item
      title - the title of this outline item
    • PdfOutline

      public PdfOutline(PdfOutline parent, PdfDestination destination, Paragraph title, boolean open)
      Constructs a PdfOutline.

      This is the constructor for an outline entry.

      Parameters:
      parent - the parent of this outline item
      destination - the destination for this outline item
      title - the title of this outline item
      open - true if the children are visible
  • Method Details

    • initOutline

      void initOutline(PdfOutline parent, String title, boolean open)
      Helper for the constructors.
      Parameters:
      parent - the parent outline
      title - the title for this outline
      open - true if the children are visible
    • setIndirectReference

      public void setIndirectReference(PdfIndirectReference reference)
      Sets the indirect reference of this PdfOutline.
      Parameters:
      reference - the PdfIndirectReference to this outline.
    • indirectReference

      public PdfIndirectReference indirectReference()
      Gets the indirect reference of this PdfOutline.
      Returns:
      the PdfIndirectReference to this outline.
    • parent

      public PdfOutline parent()
      Gets the parent of this PdfOutline.
      Returns:
      the PdfOutline that is the parent of this outline.
    • setDestinationPage

      public boolean setDestinationPage(PdfIndirectReference pageReference)
      Set the page of the PdfDestination-object.
      Parameters:
      pageReference - indirect reference to the page
      Returns:
      true if this page was set as the PdfDestination-page.
    • getPdfDestination

      public PdfDestination getPdfDestination()
      Gets the destination for this outline.
      Returns:
      the destination
    • getCount

      int getCount()
    • setCount

      void setCount(int count)
    • level

      public int level()
      returns the level of this outline.
      Returns:
      a level
    • toPdf

      public void toPdf(PdfWriter writer, OutputStream os) throws IOException
      Returns the PDF representation of this PdfOutline.
      Overrides:
      toPdf in class PdfDictionary
      Parameters:
      writer - the encryption information
      os - the OutputStream o write the bytes to
      Throws:
      IOException - on error of super.toPdf()
    • addKid

      public void addKid(PdfOutline outline)
      Adds a kid to the outline
      Parameters:
      outline - the PdfOutline to add a kid to
    • getKids

      public List<PdfOutline> getKids()
      Returns the kids of this outline
      Returns:
      an ArrayList with PdfOutlines
    • setKids

      public void setKids(List<PdfOutline> kids)
      Sets the kids of this outline
      Parameters:
      kids - the kids of the outline
    • getTag

      public String getTag()
      Getter for property tag.
      Returns:
      Value of property tag.
    • setTag

      public void setTag(String tag)
      Setter for property tag.
      Parameters:
      tag - New value of property tag.
    • getTitle

      public String getTitle()
      Gets the title of this outline
      Returns:
      the title as a String
    • setTitle

      public void setTitle(String title)
      Sets the title of this outline
      Parameters:
      title - the title of the outline
    • isOpen

      public boolean isOpen()
      Getter for property open.
      Returns:
      Value of property open.
    • setOpen

      public void setOpen(boolean open)
      Setter for property open.
      Parameters:
      open - New value of property open.
    • getColor

      public Color getColor()
      Getter for property color.
      Returns:
      Value of property color.
    • setColor

      public void setColor(Color color)
      Setter for property color.
      Parameters:
      color - New value of property color.
    • getStyle

      public int getStyle()
      Getter for property style.
      Returns:
      Value of property style.
    • setStyle

      public void setStyle(int style)
      Setter for property style.
      Parameters:
      style - New value of property style.