com.qoppa.pdf
Interface Bookmark

All Superinterfaces:
TreeNode

public interface Bookmark
extends TreeNode

This interface represents a Bookmark in a PDF document. A bookmark is essentially a node on a tree that has a list of actions associated with it and a number of children.
The class implements the TreeNode interface so that it can be used directly in a JTree.

Author:
Qoppa Software

Method Summary
 void addAction(Action action)
          Adds an Action to this Bookmark
 Bookmark addChildBookmark(String title)
          Add a child bookmark.
 Enumeration children()
          Returns the children of the node as an Enumeration.
 Vector getActions()
          Gets the list of actions for this Bookmark.
 int getBookmarkIndex(Bookmark bookmark)
          Returns the index of the bookmark node in the node's children.
 Bookmark getChildBookmarkAt(int childIndex)
          Returns the child bookmark at the given index.
 int getChildCount()
          Returns the number of children that this node contains.
 Bookmark getParentBookmark()
          Returns the parent node / Bookmark.
 Color getTextColor()
          Returns the text color that should be used when showing this bookmark.
 int getTextStyle()
          Returns the text style to use when displaying the bookmark.
 String getTitle()
          Gets this bookmarks title.
 Bookmark insertChildBookmark(String title, int index)
          Insert a child bookmark at the given index in the node's children.
 void removeChildBookmark(int index)
          Removes a child bookmark from the bookmark
 void setTextColor(Color textColor)
          Sets the text color to use when displaying this bookmark.
 void setTextStyle(int textStyle)
          Sets the text style to use when displaying this bookmark.
 void setTitle(String title)
          Sets this bookmarks title.
 String toString()
          Returns the title or name of the bookmark.
 
Methods inherited from interface javax.swing.tree.TreeNode
getAllowsChildren, getChildAt, getIndex, getParent, isLeaf
 

Method Detail

getActions

public Vector getActions()
Gets the list of actions for this Bookmark.

Returns:
A Vector containing the actions to execute when this bookmark is clicked.

addAction

public void addAction(Action action)
               throws PDFException
Adds an Action to this Bookmark

Parameters:
action - The new action
Throws:
PDFException

addChildBookmark

public Bookmark addChildBookmark(String title)
                          throws PDFException
Add a child bookmark.

Parameters:
title - The title of the new child bookmark.
Returns:
The new child Bookmark.
Throws:
PDFException

insertChildBookmark

public Bookmark insertChildBookmark(String title,
                                    int index)
Insert a child bookmark at the given index in the node's children.

Parameters:
title - The title of the new child bookmark.
index - index where the new child bookmark will be inserted
Returns:
The new child Bookmark.

getChildCount

public int getChildCount()
Returns the number of children that this node contains.

Specified by:
getChildCount in interface TreeNode
See Also:
TreeNode.getChildCount()

children

public Enumeration children()
Returns the children of the node as an Enumeration.

Specified by:
children in interface TreeNode

getParentBookmark

public Bookmark getParentBookmark()
Returns the parent node / Bookmark. This method returns the parent Bookmark for this Bookmark.


getChildBookmarkAt

public Bookmark getChildBookmarkAt(int childIndex)
Returns the child bookmark at the given index.


getBookmarkIndex

public int getBookmarkIndex(Bookmark bookmark)
Returns the index of the bookmark node in the node's children.


toString

public String toString()
Returns the title or name of the bookmark.


setTitle

public void setTitle(String title)
Sets this bookmarks title. The title is the string that is displayed in the 'outline' view of a PDF document.

Parameters:
title - The new title.

getTitle

public String getTitle()
Gets this bookmarks title. The title is the string that is displayed in the 'outline' view of a PDF document.

Returns:
The title.

getTextColor

public Color getTextColor()
Returns the text color that should be used when showing this bookmark.

Returns:
The color of the text.

setTextColor

public void setTextColor(Color textColor)
Sets the text color to use when displaying this bookmark.

Parameters:
textColor - The text color.

getTextStyle

public int getTextStyle()
Returns the text style to use when displaying the bookmark.

Returns:
The text style.

setTextStyle

public void setTextStyle(int textStyle)
Sets the text style to use when displaying this bookmark.

Parameters:
textStyle - The text style.

removeChildBookmark

public void removeChildBookmark(int index)
Removes a child bookmark from the bookmark

Parameters:
index - index of the child bookmark to remove