DynaPDF Manual - Page 866
Previous Page 865 Index Next Page 867
Function Reference
Page 866 of 874
The first four parameters are required. The last parameter is required only if IsNamedDest
and IsExternalLink are both true.
The path to an external PDF file should be a relative path. Although Unicode paths are
supported since Acrobat 8, it is usually best to restrict the character set to plain english.
This tag must be terminated with a \EK# tag. At least one character must occur between
\LK[...] and the corresponding \EK# tag. The link is created over these characters. If a
line or page break occurs before the terminating \EK# tag, the link annotation is created
over multiple text lines. This results maybe also in multiple link annotations if a page
break occurs.
Parameters of type bool can be defined as integer value 0 = false, 1 = true, or as string
(non-case-sensitive). Unlike other command tags, whitespace between values are ignored
and does not result in an error. All character codes below 33 are considered as
whitespace.
The parameter URL is passed to WebLink() if IsNamedDest is false. If IsNamedDest is true,
URL must be the name of a named destination. If IsExternalLink is false, URL is passed to
PageLink3(). If true, the function creates a link annotation and a Go To Remote Action
with CreateGoToRActionEx(). The Unicode version of WriteFText() calls
CreateGoToRActionExU() to preserve the Unicode file name.
Examples:
•
•
•
\LK[true, true, true, NameOfADestination, test.pdf]Test\EK# // Ok
•
]Test\EK# // Invalid URL!
•
\LK[true, true, true, DestName, file name with spaces.pdf ]Test\EK# // Ok
The file name in the last example is treated as "file name with spaces.pdf". Leading and
trailing spaces are ignored.
\TL[int]
The tag changes the current tabulator length. The value must be in the range 1 to 255. See
also SetTabLen().
\TR[float]
The tag changes the current text rise. Text rise can be used to create superscript or
subscript text parts inside a text block. The value must be in the range -1000 to 1000
units.
\TS[float]
The tag changes the current horizontal text scaling. The value must be greater zero. See
also SetTextScaling().
Special characters
The following list defines special characters which can be used to insert new lines, tabulators and so
on. Bidirectional characters require enabled complex text layout. See SetGStateFlags() for further
information.
Previous topic: Command tags
Next topic: Escape Sequences