DynaPDF Manual - Page 346

Previous Page 345   Index   Next Page 347

Function Reference

Page 346 of 839

typedef enum

{

efpAnsiPath

= 0, // Code page 1252 on Windows, UTF-8 otherwise

efpUnicodePath = 1, // FilePath is in Unicode format (UTF-16).

efpEmbeddable

= 2, // The font has embedding rights.

efpEditable

= 4

// The font has editing rights (important for form

// fields).

}TEnumFontProcFlags;

The function enumerates all fonts found in the search directories in the same way as

EnumHostFonts(). However, the callback function provides further information about the font such

as the font type, file path, and whether the font is embeddable or editable.

Form fields which can be edited, e.g. like text fields, require a font that is editable if the font will be

embedded. If a font has no editable rights then the fields read only flag should be set since a PDF

viewer application must replace the font if such a field would be edited. This can lead to unwanted

side effects and should be avoided. To avoid unnecessary issues, fonts with no editable rights

should not be embedded if used with form fields.

Note that the file path can be returned in Unicode or Ansi format. On Windows the string format

can be different for every font. The default string format on Windows is Unicode but the function

can also return Ansi strings, i.e. if further fonts were loaded with the Ansi version of

AddFontSearchPath().

On non-Windows operating systems the function returns always UTF-8 Unicode strings.

Remarks:

The function does not produce error messages or warnings. The internal exception handling of

DynaPDF is not used by this function.

Return values:

If the function succeeds the return value is the number of available font files or zero if no font files

were found. If the function fails the return value is a negative error code. At time of publication

negative error codes are not returned.

ExchangeBookmarks

Syntax:

LBOOL pdfExchangeBookmarks(

const PPDF* IPDF, // Instance pointer

SI32 Bmk1,

// Handle of first bookmark

SI32 Bmk2)

// Handle of second bookmark

This function exchanges two bookmarks.

Return values:

If the function succeeds the return value is 1. If the function fails the return value is 0.

Previous topic: EnumHostFontsEx

Next topic: ExchangePages, ExtractText