Foxit PDF SDK

Public Member Functions | List of all members
FoxitPDFSDKPython2.RemoteGotoAction Class Reference
Inheritance diagram for FoxitPDFSDKPython2.RemoteGotoAction:

## Public Member Functions
def | RemoteGotoAction (action)
| Constructor, with parent class object. More...
def | GetDestination ()
| Get the destination information. More...
def | GetDestinationName ()
| Get the destination name, which is defined in target PDF file. More...
def | GetFileSpec ()
| Get the file specification which specifies the destination 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 | SetDestination (destination)
| Set the destination information, which is used to specify the position in target PDF file to jump to. More...
def | SetDestinationName (dest_name)
| Set the destination name. More...
def | SetFileSpec (file_specification)
| Set the file specification which specifies the destination file. 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...
Public Member Functions inherited from FoxitPDFSDKPython2.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 FoxitPDFSDKPython2.Action
def | Create (document, action_type)
| Create a new action, for specified action type. More...
Static Public Attributes inherited from FoxitPDFSDKPython2.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

Remote go-to action is similar to an ordinary go-to action but jumps to a destination in another PDF file (not embedded file) instead of current PDF file (which contains the remote go-to action).
Class FoxitPDFSDKPython2.RemoteGotoAction is derived from Action and offers functions to get/set remote go-to action data. Destination information of a remote go-to action can be represents as either a destination array or a destination name:

- If the destination information is a destination array, Foxit PDF SDK uses a destination object to represent it and FoxitPDFSDKPython2.RemoteGotoAction.GetDestination can be used to get such value.
- If the destination information is a destination name, Foxit PDF SDK uses a string to represent it and FoxitPDFSDKPython2.RemoteGotoAction.GetDestinationName can be used to get such value. Specially, the related destination array is defined in the target PDF file, not current PDF file. User can use functions in class FoxitPDFSDKPython2.PDFNameTree to retrieve the actual destination array from target PDF file.

Destination PDF file and destination information are necessary for a remote go-to action, so user should ensure to set both data by FoxitPDFSDKPython2.RemoteGotoAction.SetFileSpec and FoxitPDFSDKPython2.RemoteGotoAction.SetDestination or FoxitPDFSDKPython2.RemoteGotoAction.SetDestinationName , especially for a new remote go-to action; otherwise, the remote go-to action would be useless.

See also
  Action

## Constructor & Destructor Documentation

## ◆ RemoteGotoAction()

def FoxitPDFSDKPython2.RemoteGotoAction.RemoteGotoAction | ( |  | action | ) |

Constructor, with parent class object.

Parameters

  [in] | action | Parent class object.

## Member Function Documentation

## ◆ GetDestination()

def FoxitPDFSDKPython2.RemoteGotoAction.GetDestination | ( |  | ) |

Get the destination information.

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 FoxitPDFSDKPython2.RemoteGotoAction.GetDestination would return a valid destination object.
- If it is a destination name, function FoxitPDFSDKPython2.RemoteGotoAction.GetDestinationName would return a valid string, and the destination name would be defined in the target PDF file.

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

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

## ◆ GetDestinationName()

def FoxitPDFSDKPython2.RemoteGotoAction.GetDestinationName | ( |  | ) |

Get the destination name, which is defined in 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 FoxitPDFSDKPython2.RemoteGotoAction.GetDestination would return a valid destination object.
- If it is a destination name, function FoxitPDFSDKPython2.RemoteGotoAction.GetDestinationName would return a valid string, and the destination name would be defined in the target PDF file.

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

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

## ◆ GetFileSpec()

def FoxitPDFSDKPython2.RemoteGotoAction.GetFileSpec | ( |  | ) |

Get the file specification which specifies the destination file.

Returns
  A non-embedded file specification object.

## ◆ GetNewWindowFlag()

def FoxitPDFSDKPython2.RemoteGotoAction.GetNewWindowFlag | ( |  | ) |

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

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

## ◆ SetDestination()

def FoxitPDFSDKPython2.RemoteGotoAction.SetDestination | ( |  | destination | ) |

Set the destination information, which is used to specify the position in target PDF file to jump to.

Parameters

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

Returns
  None.

## ◆ SetDestinationName()

def FoxitPDFSDKPython2.RemoteGotoAction.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 be not be an empty string.

Returns
  None.

## ◆ SetFileSpec()

def FoxitPDFSDKPython2.RemoteGotoAction.SetFileSpec | ( |  | file_specification | ) |

Set the file specification which specifies the destination file.

Parameters

  [in] | file_specification | A valid file specification object to be set. This object should belong to the same PDF file as current action. It should represent another PDF file as the target file, and should not represent an embedded file.

Returns
  None.

## ◆ SetNewWindowFlag()

def FoxitPDFSDKPython2.RemoteGotoAction.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: FoxitPDFSDKPython2.Action.e_NewWindowFlagTrue means to open the destination document in a new window. FoxitPDFSDKPython2.Action.e_NewWindowFlagFalse means that the destination document replaces current document in the same window. FoxitPDFSDKPython2.Action.e_NewWindowFlagNone means that such flag is not needed and the viewer application should behave in accordance with the current user preference.

Returns
  None.