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 EmbeddedGotoTarget is derived from Action and offers functions to get/set embedded go-to action data.
- See also
- Action
- Examples
- /Users/ec2-user/gitlab-runner/builds/E-xKdhDo/0/foxit/sdk/mobile/gsdk-doc-auto-build/harmony_nodejs/input/Index.js.
◆ constructor()
| EmbeddedGotoAction.constructor |
( |
action |
| ) |
|
Constructor, with parent class object.
- Parameters
-
| [in] | action | Parent class object. |
◆ GetDestination()
| 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 the return value of function Destination.IsEmpty for the returned destination object is true and function 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 Destination.IsEmpty for the returned destination object is true, please try function EmbeddedGotoAction.GetDestinationName.
◆ GetDestinationName()
| 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 the return value of function Destination.IsEmpty for the returned destination object is true and function 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 EmbeddedGotoAction.GetDestination.
◆ GetNewWindowFlag()
| 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:
◆ GetRootFile()
| 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 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()
| EmbeddedGotoAction.GetTarget |
( |
| ) |
|
Get the target.
- Returns
- An embedded goto target object. If the return value of function EmbeddedGotoTarget.IsEmpty for the returned embedded goto target object is true, that means no target.
◆ SetDestination()
| 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()
| 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()
| 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:
|
- Returns
- None.
◆ SetRootFile()
| 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()
| 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.