DynaPDF Manual - Page 270

Previous Page 269   Index   Next Page 271

Function Reference
Page 270 of 839
CreateGoToActionEx
Syntax:
SI32 pdfCreateGoToActionEx(
const PPDF* IPDF, // Instance pointer
UI32 NamedDest)
// Handle of a named destination
The function creates a go-to action which uses a named destination to open the target page. A
named destination can be used if the destination should be accessible from another PDF file. See
also CreateNamedDest().
Remarks:
Actions must be added to a PDF object with AddActionToObj().
Return values:
If the function succeeds the return value is the action handle, a value greater or equal zero. If the
function fails the return value is a negative error code.
CreateGoToEAction
Syntax:
SI32 pdfCreateGoToEAction(
const PPDF* IPDF,
// Instance pointer
TEmbFileLocation Location, // see below
const char* Source,
// Required for external files
UI32 SrcPage,
// If the file is located in an annotation
const char* Target,
// The target file that should be opened
const char* DestName,
// A named destination to be opened
UI32 DestPage,
// Only used if DestName is NULL
LBOOL NewWindow)
// Open the file in a new window?
typedef enum
{
eflChild,
// The file is embedded in the current file
eflChildAnnot,
// The file is embedded in a file attachment annotation
eflExternal,
// The file is an embedded file in an external file
eflExternalAnnot, // The file is embedded in a file attachment annotation
eflParent,
// The file is located in the parent document
eflParentAnnot
// The file is located in a file attachment annotation
}TEmbFileLocation;
The function creates an embedded GoTo action. This action type opens an embedded PDF file that is
located in the current, parent, or in an external PDF file.
Embedded files can be attached directly, e.g. with AttachFile(), or embedded in file attachment
annotations with FileAttachAnnot().
The parameter Location specifies where the embedded file can be found. File attachment annotations
are stored in pages and not globally like ordinary file attachments. Therefore, the source page in
 

Previous topic: CreateGoToAction

Next topic: CreateGoToRAction