Foxit PDF SDK

Public Member Functions | List of all members
FoxitPDFSDKPython3.EmbeddedGotoAction Class Reference
Inheritance diagram for FoxitPDFSDKPython3.EmbeddedGotoAction:

## Public Member Functions
def | EmbeddedGotoAction (action)
| Constructor, with parent class object. More...
def | GetDestination ()
| Get the destination information which specifies where to jump to in the final target file. More...
def | GetDestinationName ()
| Get the destination name which is defined in final target PDF file. More...
def | GetNewWindowFlag ()
| Get the flag which is used to decide whether to open the destination document in a new window or not. More...
def | GetRootFile ()
| Get the file specification of the root file which is the root file for the target. More...
def | GetTarget ()
| Get the target. More...
def | SetDestination (destination)
| Set the destination information which specifies where to jump to in the final target file. More...
def | SetDestinationName (dest_name)
| Set the destination name. More...
def | SetNewWindowFlag (flag)
| Set the flag which is used to decide whether to open the destination document in a new window or not. More...
def | SetRootFile (file_specification)
| Set the file specification of the root file which is the root file for the target. More...
def | SetTarget (target)
| Set the target. More...
Public Member Functions inherited from FoxitPDFSDKPython3.Action
def | Action (action)
| Constructor, with another action object. More...
def | GetDict ()
| Get PDF dictionary of current object. More...
def | GetDocument ()
| Get the PDF document, to which current action belongs. More...
def | GetSubAction (index)
| Get a sub-action by index. More...
def | GetSubActionCount ()
| Get the count of sub-actions. More...
def | GetType ()
| Get action type. More...
def | InsertSubAction (index, sub_action)
| Insert a new sub-action to the location specified by index. More...
def | IsEmpty ()
| Check whether current object is empty or not. More...
def | RemoveAllSubActions ()
| Remove all the sub-actions. More...
def | RemoveSubAction (index)
| Remove a sub-action, specified by index. More...
def | SetSubAction (index, sub_action)
| Set a sub-action by index. More...

## Additional Inherited Members
Static Public Member Functions inherited from FoxitPDFSDKPython3.Action
def | Create (document, action_type)
| Create a new action, for specified action type. More...
Static Public Attributes inherited from FoxitPDFSDKPython3.Action
| e_NewWindowFlagFalse = _fsdk.Action_e_NewWindowFlagFalse
| "NewWindow" flag is false.
| e_NewWindowFlagNone = _fsdk.Action_e_NewWindowFlagNone
| No "NewWindow" flag.
| e_NewWindowFlagTrue = _fsdk.Action_e_NewWindowFlagTrue
| "NewWindow" flag is true.
| e_TypeGoto = _fsdk.Action_e_TypeGoto
| Action type: go-to action.
| e_TypeGoTo3DView = _fsdk.Action_e_TypeGoTo3DView
| Action type: go-to-3D-view action.
| e_TypeGoToE = _fsdk.Action_e_TypeGoToE
| Action type: embedded go-to action.
| e_TypeGoToR = _fsdk.Action_e_TypeGoToR
| Action type: remote go-to action.
| e_TypeHide = _fsdk.Action_e_TypeHide
| Action type: hide action.
| e_TypeImportData = _fsdk.Action_e_TypeImportData
| Action type: import-data action.
| e_TypeJavaScript = _fsdk.Action_e_TypeJavaScript
| Action type: JavaScript action.
| e_TypeLaunch = _fsdk.Action_e_TypeLaunch
| Action type: launch action.
| e_TypeMovie = _fsdk.Action_e_TypeMovie
| Action type: movie action.
| e_TypeNamed = _fsdk.Action_e_TypeNamed
| Action type: named action.
| e_TypeRendition = _fsdk.Action_e_TypeRendition
| Action type: rendition action.
| e_TypeResetForm = _fsdk.Action_e_TypeResetForm
| Action type: reset-form action.
| e_TypeSetOCGState = _fsdk.Action_e_TypeSetOCGState
| Action type: set-OCG-state action.
| e_TypeSound = _fsdk.Action_e_TypeSound
| Action type: sound action.
| e_TypeSubmitForm = _fsdk.Action_e_TypeSubmitForm
| Action type: submit-form action.
| e_TypeThread = _fsdk.Action_e_TypeThread
| Action type: thread action.
| e_TypeTrans = _fsdk.Action_e_TypeTrans
| Action type: transition action.
| e_TypeUnknown = _fsdk.Action_e_TypeUnknown
| Action type: unknown action.
| e_TypeURI = _fsdk.Action_e_TypeURI
| Action type: uniform resource identifier (URI) action.

## Detailed Description

Embedded go-to action is similar to a remote go-to action but allows jumping to or from a PDF file that is embedded in another PDF file. Class FoxitPDFSDKPython3.EmbeddedGotoTarget is derived from Action and offers functions to get/set embedded go-to action data.

See also
  Action

## Constructor & Destructor Documentation

## ◆ EmbeddedGotoAction()

def FoxitPDFSDKPython3.EmbeddedGotoAction.EmbeddedGotoAction | ( |  | action | ) |

Constructor, with parent class object.

Parameters

  [in] | action | Parent class object.

## Member Function Documentation

## ◆ GetDestination()

def FoxitPDFSDKPython3.EmbeddedGotoAction.GetDestination | ( |  | ) |

Get the destination information which specifies where to jump to in the final target file.

For a embedded go-to action, the destination information can be stored as either a destination object or a destination name:

- If it is a destination object, function FoxitPDFSDKPython3.EmbeddedGotoAction.GetDestination would return a valid destination object.
- If it is a destination name, function FoxitPDFSDKPython3.EmbeddedGotoAction.GetDestinationName would return a valid string, and the destination name would be defined in the final target PDF file.

If the return value of function FoxitPDFSDKPython3.Destination.IsEmpty for the returned destination object is true and function FoxitPDFSDKPython3.EmbeddedGotoAction.GetDestinationName returns an empty string, that means the embedded go-to action does not have any destination information.

Returns
  A destination object. If the return value of function FoxitPDFSDKPython3.Destination.IsEmpty for the returned destination object is true, please try function FoxitPDFSDKPython3.EmbeddedGotoAction.GetDestinationName .

## ◆ GetDestinationName()

def FoxitPDFSDKPython3.EmbeddedGotoAction.GetDestinationName | ( |  | ) |

Get the destination name which is defined in final target PDF file.

For a remote go-to action, the destination information can be stored as either a destination object or a destination name:

- If it is a destination object, function FoxitPDFSDKPython3.EmbeddedGotoAction.GetDestination would return a valid destination object.
- If it is a destination name, function FoxitPDFSDKPython3.EmbeddedGotoAction.GetDestinationName would return a valid string, and the destination name would be defined in the target PDF file.

If the return value of function FoxitPDFSDKPython3.Destination.IsEmpty for the returned destination object is true and function FoxitPDFSDKPython3.EmbeddedGotoAction.GetDestinationName returns an empty string, that means the embedded go-to action does not have any destination information.

Returns
  The destination name. If this function returns an empty string, please try function FoxitPDFSDKPython3.EmbeddedGotoAction.GetDestination .

## ◆ GetNewWindowFlag()

def FoxitPDFSDKPython3.EmbeddedGotoAction.GetNewWindowFlag | ( |  | ) |

Get the flag which is used to decide whether to open the destination document in a new window or not.

Returns
  The new windows flag. It would be one of following values:
  - FoxitPDFSDKPython3.Action.e_NewWindowFlagTrue means to open the destination document in a new window.
  - FoxitPDFSDKPython3.Action.e_NewWindowFlagFalse means that the destination document replaces current document in the same window.
  - FoxitPDFSDKPython3.Action.e_NewWindowFlagNone means that no such flag and the viewer application should behave in accordance with the current user preference.

## ◆ GetRootFile()

def FoxitPDFSDKPython3.EmbeddedGotoAction.GetRootFile | ( |  | ) |

Get the file specification of the root file which is the root file for the target.

Returns
  A non-embedded file specification object. If the return value of function FoxitPDFSDKPython3.FileSpec.IsEmpty for the returned file specification object is true, that means the PDF file which contains current embedded goto action is just the root file for target object.

## ◆ GetTarget()

def FoxitPDFSDKPython3.EmbeddedGotoAction.GetTarget | ( |  | ) |

Get the target.

Returns
  An embedded goto target object. If the return value of function FoxitPDFSDKPython3.EmbeddedGotoTarget.IsEmpty for the returned embedded goto target object is true, that means no target.

## ◆ SetDestination()

def FoxitPDFSDKPython3.EmbeddedGotoAction.SetDestination | ( |  | destination | ) |

Set the destination information which specifies where to jump to in the final target file.

Parameters

  [in] | destination | A valid destination object to be set.

Returns
  None.

## ◆ SetDestinationName()

def FoxitPDFSDKPython3.EmbeddedGotoAction.SetDestinationName | ( |  | dest_name | ) |

Set the destination name.

The destination name should have been in the "Dests" name tree in the target PDF file.

Parameters

  [in] | dest_name | A destination name to be set. It should not be an empty string.

Returns
  None.

## ◆ SetNewWindowFlag()

def FoxitPDFSDKPython3.EmbeddedGotoAction.SetNewWindowFlag | ( |  | flag | ) |

Set the flag which is used to decide whether to open the destination document in a new window or not.

Parameters

  [in] | flag | The new window flag. It should be one of following values: FoxitPDFSDKPython3.Action.e_NewWindowFlagTrue means to open the destination document in a new window. FoxitPDFSDKPython3.Action.e_NewWindowFlagFalse means that the destination document replaces current document in the same window. FoxitPDFSDKPython3.Action.e_NewWindowFlagNone means that no such flag and the viewer application should behave in accordance with the current user preference.

Returns
  None.

## ◆ SetRootFile()

def FoxitPDFSDKPython3.EmbeddedGotoAction.SetRootFile | ( |  | file_specification | ) |

Set the file specification of the root file which is the root file for the target.

Parameters

  [in] | file_specification | The file specification object: It can be constructed by default constructor and not set any value. In this case, that means the PDF file which contains current embedded goto action is also the root file for target. Otherwise, this should be a valid file specification object, and should represent another file, not an embedded file. The file specification object should be in the same PDF file as current action.

Returns
  None.

## ◆ SetTarget()

def FoxitPDFSDKPython3.EmbeddedGotoAction.SetTarget | ( |  | target | ) |

Set the target.

Parameters

  [in] | target | An embedded goto target object. If this is constructed by default constructor and has not been set any value, that means no target.

Returns
  None.