Foxit PDF SDK
FoxitPDFSDKPython3.Bookmark Class Reference
Inheritance diagram for FoxitPDFSDKPython3.Bookmark:
FoxitPDFSDKPython3.Base

Public Member Functions

def Bookmark (other)
 Constructor, with another bookmark object.
More...
 
def GetAction ()
 Get action.
More...
 
def GetColor ()
 Get the color used for displaying title.
More...
 
def GetDestination ()
 Get the destination.
More...
 
def GetDict ()
 Get PDF dictionary of current bookmark.
More...
 
def GetFirstChild ()
 Get the first child bookmark.
More...
 
def GetNextSibling ()
 Get the next sibling bookmark.
More...
 
def GetParent ()
 Get the parent bookmark.
More...
 
def GetStyle ()
 Get the style.
More...
 
def GetTitle ()
 Get the title.
More...
 
def HasChild ()
 Check if current bookmark has child bookmark(s).
More...
 
def Insert (title, position)
 Insert a new bookmark according to the relationship position to current bookmark.
More...
 
def IsEmpty ()
 Check whether current object is empty or not.
More...
 
def IsFirstChild ()
 Check if current bookmark is the first child of its parent bookmark.
More...
 
def IsLastChild ()
 Check if current bookmark is the last child of its parent bookmark.
More...
 
def IsRoot ()
 Check if current bookmark is the root bookmark.
More...
 
def MoveTo (dest_bookmark, position)
 Move current bookmark to be child or sibling of another bookmark.
More...
 
def RemoveAction ()
 Remove action.
More...
 
def SetAction (action)
 Set action.
More...
 
def SetColor (color)
 Set the color used for displaying title.
More...
 
def SetDestination (destination)
 Set the destination.
More...
 
def SetStyle (style)
 Set the style.
More...
 
def SetTitle (title)
 Set the title.
More...
 

Static Public Attributes

 e_PosFirstChild = _fsdk.Bookmark_e_PosFirstChild
 A bookmark is the first child of another specified bookmark.

 
 e_PosFirstSibling = _fsdk.Bookmark_e_PosFirstSibling
 A bookmark is the first sibling of another specified bookmark.

 
 e_PosLastChild = _fsdk.Bookmark_e_PosLastChild
 A bookmark is the last child of another specified bookmark.

 
 e_PosLastSibling = _fsdk.Bookmark_e_PosLastSibling
 A bookmark is the last sibling of another specified bookmark.

 
 e_PosNextSibling = _fsdk.Bookmark_e_PosNextSibling
 A bookmark is the next sibling of another specified bookmark.

 
 e_PosPrevSibling = _fsdk.Bookmark_e_PosPrevSibling
 A bookmark is the previous sibling of another specified bookmark.

 
 e_StyleBold = _fsdk.Bookmark_e_StyleBold
 Show bookmark title as bold text.

 
 e_StyleItalic = _fsdk.Bookmark_e_StyleItalic
 Show bookmark title as italic text.

 
 e_StyleNormal = _fsdk.Bookmark_e_StyleNormal
 Show bookmark title as normal text.

 

Detailed Description

PDF bookmark is also called "outline". It's a tree-structured hierarchy. It allows user to navigate PDF document easily by selecting a bookmark. One bookmark contains a destination or actions to indicate how to response when user selects it.
In order to get/set the bookmark tree, function FoxitPDFSDKPython3.PDFDoc.GetRootBookmark must be called first to get the root of the whole bookmark tree. If the "root bookmark" does not exist, function FoxitPDFSDKPython3.PDFDoc.CreateRootBookmark could be called to create a new "root bookmark". Here, "root bookmark" is an abstract object. It represents the "Outline" of PDF document. For more details about "Outline", please refer to Section 8.2.3 in PDF Reference 1.7. "root bookmark" can only have some child bookmarks, but no parent, no next sibling bookmarks or any data (including bookmark data, destination data and action data). And "root bookmark" cannot be shown on the application UI since it has no data. So, for a root bookmark, only function FoxitPDFSDKPython3.Bookmark.GetFirstChild can be used.
From the root bookmark, the bookmark tree can be traversed and each bookmark node can be accessed.
This class offers several functions to get/set other bookmarks from current bookmark. For example:

This class also offers functions to get/set the data of a PDF bookmark.

See also
PDFDoc

Constructor & Destructor Documentation

◆ Bookmark()

def FoxitPDFSDKPython3.Bookmark.Bookmark (   other)

Constructor, with another bookmark object.

Parameters
[in]otherAnother bookmark object.

Member Function Documentation

◆ GetAction()

def FoxitPDFSDKPython3.Bookmark.GetAction ( )

Get action.

If current bookmark is returned by function FoxitPDFSDKPython3.PDFDoc.GetRootBookmark or FoxitPDFSDKPython3.PDFDoc.CreateRootBookmark , that means it is the "root bookmark", and it does not have any action information. In this case, this function will return an action object which's function FoxitPDFSDKPython3.Action.IsEmpty returns true.

Returns
An action object.

◆ GetColor()

def FoxitPDFSDKPython3.Bookmark.GetColor ( )

Get the color used for displaying title.

If current bookmark is returned by function FoxitPDFSDKPython3.PDFDoc.GetRootBookmark or FoxitPDFSDKPython3.PDFDoc.CreateRootBookmark , that means it is the "root bookmark", and it does not have color. In this case, this function will return 0x000000 by default.

Returns
The color used for displaying title. Format: 0xRRGGBB.

◆ GetDestination()

def FoxitPDFSDKPython3.Bookmark.GetDestination ( )

Get the destination.

Bookmark's destination is some place in current document where the bookmark can "goto". If the bookmark cannot "goto" any place in current document, that means no destination information can be retrieved and this function will return a destination object which's function FoxitPDFSDKPython3.Destination.IsEmpty returns true.
If current bookmark is returned by function FoxitPDFSDKPython3.PDFDoc.GetRootBookmark or FoxitPDFSDKPython3.PDFDoc.CreateRootBookmark , that means it is the "root bookmark", and it does not have any destination information. In this case, this function will return a destination object which's function FoxitPDFSDKPython3.Destination.IsEmpty returns true.

Returns
The destination object.

◆ GetDict()

def FoxitPDFSDKPython3.Bookmark.GetDict ( )

Get PDF dictionary of current bookmark.

Returns
The PDF dictionary. If there is any error, this function will return null.

◆ GetFirstChild()

def FoxitPDFSDKPython3.Bookmark.GetFirstChild ( )

Get the first child bookmark.

Returns
The first child bookmark object.

◆ GetNextSibling()

def FoxitPDFSDKPython3.Bookmark.GetNextSibling ( )

Get the next sibling bookmark.

If current bookmark is returned by function FoxitPDFSDKPython3.PDFDoc.GetRootBookmark or FoxitPDFSDKPython3.PDFDoc.CreateRootBookmark , that means it is the "root bookmark", and it does not have any sibling bookmark. In this case, this function will return a bookmark object which's function FoxitPDFSDKPython3.Bookmark.IsEmpty returns true.

Returns
The next sibling bookmark object.

◆ GetParent()

def FoxitPDFSDKPython3.Bookmark.GetParent ( )

Get the parent bookmark.

If current bookmark is returned by function FoxitPDFSDKPython3.PDFDoc.GetRootBookmark or FoxitPDFSDKPython3.PDFDoc.CreateRootBookmark , that means it is the "root bookmark", and it does not have a parent bookmark. In this case, this function will return a bookmark object which's function FoxitPDFSDKPython3.Bookmark.IsEmpty returns true.

Returns
The parent bookmark object.

◆ GetStyle()

def FoxitPDFSDKPython3.Bookmark.GetStyle ( )

Get the style.

If current bookmark is returned by function FoxitPDFSDKPython3.PDFDoc.GetRootBookmark or FoxitPDFSDKPython3.PDFDoc.CreateRootBookmark , that means it is the "root bookmark", and it does not have style information. In this case, this function will return FoxitPDFSDKPython3.Bookmark.e_StyleNormal by default.

Returns
Value for The bookmark style. Please refer to values starting from FoxitPDFSDKPython3.Bookmark.e_StyleNormal and this would be one or a combination of these values.

◆ GetTitle()

def FoxitPDFSDKPython3.Bookmark.GetTitle ( )

Get the title.

If current bookmark is returned by function FoxitPDFSDKPython3.PDFDoc.GetRootBookmark or FoxitPDFSDKPython3.PDFDoc.CreateRootBookmark , that means it is the "root bookmark", and it does not have title. In this case, this function will return an empty string.

Returns
The title string.

◆ HasChild()

def FoxitPDFSDKPython3.Bookmark.HasChild ( )

Check if current bookmark has child bookmark(s).

Returns
true means current bookmark has child bookmark(s), and false means current bookmark does not have any child bookmark.

◆ Insert()

def FoxitPDFSDKPython3.Bookmark.Insert (   title,
  position 
)

Insert a new bookmark according to the relationship position to current bookmark.

For the new bookmark, the color would be 0x000000 and the style would be FoxitPDFSDKPython3.Bookmark.e_StyleNormal by default.

Parameters
[in]titleTitle string for the new bookmark. It should not be an empty string.
[in]positionThe position where the new bookmark item is to be inserted, based on current bookmark. Please refer to values starting from FoxitPDFSDKPython3.Bookmark.e_PosFirstChild and this should be one of these values.
If current bookmark is just the "root bookmark", parameter position can only be FoxitPDFSDKPython3.Bookmark.e_PosFirstChild or FoxitPDFSDKPython3.Bookmark.e_PosLastChild .
Returns
A new bookmark object.

◆ IsEmpty()

def FoxitPDFSDKPython3.Bookmark.IsEmpty ( )

Check whether current object is empty or not.

When the current object is empty, that means current object is useless.

Returns
true means current object is empty, while false means not.

◆ IsFirstChild()

def FoxitPDFSDKPython3.Bookmark.IsFirstChild ( )

Check if current bookmark is the first child of its parent bookmark.

Returns
true means current bookmark is the first child of its parent bookmark, while false means not.

◆ IsLastChild()

def FoxitPDFSDKPython3.Bookmark.IsLastChild ( )

Check if current bookmark is the last child of its parent bookmark.

Returns
true means current bookmark is the last child of its parent bookmark, while false means not.

◆ IsRoot()

def FoxitPDFSDKPython3.Bookmark.IsRoot ( )

Check if current bookmark is the root bookmark.

"root bookmark" is an abstract object. It represents the "Outline" of PDF document. For more details about "Outline", please refer to Section 8.2.3 in PDF Reference 1.7. "root bookmark" can only have some child bookmarks, but no parent, no next sibling bookmarks or any data (including bookmark data, destination data and action data). And "root bookmark" cannot be shown on the application UI since it has no data.

Returns
true means current bookmark is the root bookmark, while false means not.

◆ MoveTo()

def FoxitPDFSDKPython3.Bookmark.MoveTo (   dest_bookmark,
  position 
)

Move current bookmark to be child or sibling of another bookmark.

If current bookmark is returned by function FoxitPDFSDKPython3.PDFDoc.GetRootBookmark or FoxitPDFSDKPython3.PDFDoc.CreateRootBookmark , that means it is the "root bookmark", and it cannot be moved to be child or sibling of any bookmark in the bookmark tree. In this case, this function will return false directly.

Parameters
[in]dest_bookmarkThe destination bookmark. It should not be current bookmark itself or any descendant of current bookmark.
Current bookmark will be moved to be child or sibling of the destination bookmark.
[in]positionThe position where the current bookmark is to be moved to, based on parameter destBookmark. Please refer to values starting from FoxitPDFSDKPython3.Bookmark.e_PosFirstChild and this should be one of these values.
Returns
true means success, while false means failure.

◆ RemoveAction()

def FoxitPDFSDKPython3.Bookmark.RemoveAction ( )

Remove action.

When removing bookmark's action, bookmark's destination will be removed at the same time.
If current bookmark is returned by function FoxitPDFSDKPython3.PDFDoc.GetRootBookmark or FoxitPDFSDKPython3.PDFDoc.CreateRootBookmark , that means it is the "root bookmark", and it does not have any action information. In this case, this function will return true directly.

Returns
true means success, while false means failure.

◆ SetAction()

def FoxitPDFSDKPython3.Bookmark.SetAction (   action)

◆ SetColor()

def FoxitPDFSDKPython3.Bookmark.SetColor (   color)

Set the color used for displaying title.

If current bookmark is returned by function FoxitPDFSDKPython3.PDFDoc.GetRootBookmark or FoxitPDFSDKPython3.PDFDoc.CreateRootBookmark , that means it is the "root bookmark", and it does not have color. In this case, this function will return directly without doing anything.

Parameters
[in]colorNew color used for displaying title. Format:0xRRGGBB.
Returns
None.

◆ SetDestination()

def FoxitPDFSDKPython3.Bookmark.SetDestination (   destination)

Set the destination.

Bookmark's destination is some place in current document where the bookmark can "goto".
If current bookmark is returned by function FoxitPDFSDKPython3.PDFDoc.GetRootBookmark or FoxitPDFSDKPython3.PDFDoc.CreateRootBookmark , that means it is the "root bookmark", and it does not have any destination information. In this case, this function will return directly without doing anything.

Parameters
[in]destinationA valid destination.
Returns
None.

◆ SetStyle()

def FoxitPDFSDKPython3.Bookmark.SetStyle (   style)

Set the style.

If current bookmark is returned by function FoxitPDFSDKPython3.PDFDoc.GetRootBookmark or FoxitPDFSDKPython3.PDFDoc.CreateRootBookmark , that means it is the "root bookmark", and it does not have style information. In this case, this function will return directly without doing anything.

Parameters
[in]styleNew bookmark style. Please refer to values starting from FoxitPDFSDKPython3.Bookmark.e_StyleNormal and this can be one or a combination of these values. If the style is invalid, FoxitPDFSDKPython3.Bookmark.e_StyleNormal will be set by default.
Returns
None.

◆ SetTitle()

def FoxitPDFSDKPython3.Bookmark.SetTitle (   title)

Set the title.

If current bookmark is returned by function FoxitPDFSDKPython3.PDFDoc.GetRootBookmark or FoxitPDFSDKPython3.PDFDoc.CreateRootBookmark , that means it is the "root bookmark", and it does not have title. In this case, this function will return directly without doing anything.

Parameters
[in]titleNew title string. It should not be an empty string.
Returns
None.