DynaPDF Manual - Page 831

Previous Page 830   Index   Next Page 832

Function Reference
Page 831 of 839
It is also possible to create a numbered list:
If no value is defined, the character index 159 of the font Wingdings-Regular is used
as list symbol. This is the same character as you see in this list.
A value between 32 to 255 is treated as character index of the current list font. If no
list font was set it defaults to the font Wingdings-Regular which is normally
available on all Windows operating systems. Make sure that this font is available
under Linux or UNIX.
Values in the ranges 0 to 31 and 256 to 999 are not valid; the list will not be created.
Since the Unicode index of the bullet character is above 1000 (decimal 8226 or hex
2022), the Unicode version of WriteFText() supports also an arbitrary Unicode
character after the comma to specify the list symbol. The Unicode index of this
character must be greater 33 and no number (48..57).
Values greater or equal 1000 are used to create a numbered list. The function
subtracts 1000 from the number and prints the resulting number as list symbol plus
a dot using the current font:
"\\LI[10,1001]This is a numbered list!\\EL#" =
1.
This is a numbered list!
A list supports the alignments left and justified text only. Right aligned or centred text
produce unpredictable output. A list must be finished with the tag \EL#. The default
distance between the list character and the text is 10 units.
\LK[bool,
This tag adds a link to a page. The parameters are as follows:
bool,bool,
char*,char*]
IsNamedDest (false or 0, true or 1)
IsExternalLink (false or 0, true or 1)
OpenInNewWindow (false or 0, true or 1)
URL or name of a named destination (see CreateNamedDest())
PDF file in which the named destination is located
Link annotations support more properties which must be set before calling WriteFText():
Border width
-> SetLineWidth()
Border dash pattern
-> SetLineDashPattern()
Border color
-> SetStrokeColor()
Border color space
-> SetStrokeColorSpace()
Highlight mode
-> SetLinkHighlightMode()
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
 

Previous topic: Command tags

Next topic: Special characters