DynaPDF Manual - Page 871

Previous Page 870   Index   Next Page 872

Function Reference

Page 871 of 883

font, the output rectangle or closing the current page and opening another one so that

the remaining text can be printed.

If no callback function was set, the current page will be closed and the remaining text

will be printed on the next page by using the same output rectangle. See also

SetOnPageBreakProc(), ConnectPageBreakEvent().

\BM[char*]

WriteFText adds a bookmark with a destination of type dtXY_Zoom, and the x, y

coordinate will be set to the position where this tag appears (the y-coordinate system is

the baseline plus leading), the zoom factor is left unchanged. The parameter of the tag is

the bookmark's title. Note that the title is not printed onto the page. To print the

bookmarks title onto the page, add the string behind the tag again:

"\BM[My first bookmark...]My first bookmark..."

The bookmark title and the string that appears on the page can be different.

\CS[float]

The tag changes the current character spacing. The value must be in the range -1000 to

1000 units. Note that negative values push the characters into the others. See also

SetCharacterSpacing().

\EH#

End of highlight annotation. It requires a preceding \HA[] tag.

\EK#

This is an end of link tag. It requires a preceding \LK[] tag.

\EL#

This is an end of list marker. It requires a preceding create list tag, see above. The tag

turns off the current list so that the following text can be printed in the usual way.

\FC[UI32]

The tag changes the current font color. The color value must be defined in the current

color space. See also SetFillColor().

\FS[float]

The tag changes the current font size. The new font size must be greater zero.

\FT[various]

This tag changes the current font. The font can be changed by using a font handle or a

font name. If a font handle is used, the font(s) must be loaded beforehand with SetFont(),

SetFontEx(), or SetCIDFont(). Unused fonts are removed by DynaPDF, they will not be

added to the file.

The second way to change the font is by using a font name. If nothing else is specified,

the specified name is interpreted as Postscript name.

Example: "\FT[ArialMT]Some text..."

Since DynaPDF 4.0.46.132 it is also possible to specify the font name as Family Name or

Full Name. In addition, it is possible to define up to three alternate fonts. The search run

continues until a font of the list can be successfully loaded.

It is possible to combine all formats as needed. That means every font can be specified

either as font handle, PostScript Name, Family Name, or Full Name.

Previous topic: Command tags

Next topic: Special characters