Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 6.1   6.2   6.3   6.4   6.5   7.0   7.1   7.2   7.3   7.4    Statistic  

DynaPDF.CreateNamedDest

The function creates a named destination that can be accessed from external PDF files.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
DynaPDF 4.4 Yes Yes Yes Yes Yes

MBS( "DynaPDF.CreateNamedDest"; PDF; Name; DestPage; DestType { ; a; b; c; d } )

Parameters

Parameter Description Example value
PDF The PDF reference returned from DynaPDF.New. $pdf
Name Name of the destination "Chapter1"
DestPage Destination Page 5
DestType The type of destination, can be XYZoom, Fit, FitHTop, FitVLeft, FitRect, FitB, FitBHTop or FitBVLeft. "Fit"
a Optional
optional parameter
b Optional
optional parameter
c Optional
optional parameter
d Optional
optional parameter

Result

Returns number or error.

Description

The function creates a named destination that can be accessed from external PDF files.
Named destinations are useful if the destination must be accessed from another PDF file. For example, a link to the beginning of Chapter 3 in another document might refer to the destination by a name, such as Chap3.begin, instead of an explicit page number in the other document. This makes it possible to change the destination in the document without invalidating the external link that refers to the destination.
Named destinations can be used in the same document by bookmarks, page links, and go-to actions. This makes it possible to share named destinations with external and internal links. Named destinations which are located in another document can be accessed with a go-to-remote action (see DynaPDF.CreateGoToRActionEx for further information).
The different destination types are described in detail at DynaPDF.CreateGoToAction.
To avoid unnecessary problems it is usually best to use 7 bit Ansi strings for named destinations.
If the function succeeds the return value is the destination handle, a value greater or equal zero. If the function fails the return value is an error message.

See also CreateNamedDest function in DynaPDF manual.

Examples

Created named dest and add a bookmark using it:

$NamedDest = MBS("DynaPDF.CreateNamedDest"; $pdf; "link" & Create Text::DestPage; Create Text::DestPage; "FitRect"; 100; 200; 300; 400)
$b = MBS("DynaPDF.AddBookmarkEx"; $pdf; Create Text::Title; Create Text::Parent; $NamedDest; Create Text::Open)

See also


DynaPDF.CreateListBox   -   DynaPDF.CreateRadioButton

Feedback: Report problem or ask question.




Links
MBS Xojo Chart Plugins