DynaPDF Manual - Page 136

Previous Page 135   Index   Next Page 137

Function Reference
Page 136 of 839
AddFileComment
Syntax:
SI32 pdfAddFileComment(
const PPDF* IPDF,
// Instance pointer
const char* AText) // The comment that should be added
Under certain circumstances it can be useful to add one or more comments to a PDF file which are
not visible on screen or elsewhere in PDF viewer applications. The function AddFileComment() can
be used to add such comments to the end of the PDF file.
Comments are stored behind the %%EOF marker of the PDF file. The required space to save all
comments should not exceed 1024 bytes. However, all tests with larger comments didn't produce an
error in Adobe's Acrobat, but Ghostview fails if the space exceeds ~2000 bytes.
Remarks:
This function is implemented in an Ansi and Unicode compatible version. However, Unicode
strings are converted back to Ansi; unsupported characters appear as question mark (?).
File comments are prohibited in certain PDF standards like PDF/A.
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
AddFontSearchPath
Syntax:
SI32 pdfAddFontSearchPath(
const PPDF* IPDF,
// Instance pointer
const char* APath, // Path to font file directory
SI32 Recursive)
// Include subdirectories (search recursively)
This function adds a search path to the list of available font search paths. An arbitrary number of
search paths can be added at runtime. Subdirectories are added recursively if the parameter
Recursive is true.
DynaPDF requires no separate metric files for Type1 fonts.
This function is implemented in an Ansi and Unicode compatible version. On non-Windows
operating systems, Unicode paths are converted to UTF-8 and passed to the Ansi version of the
function.
Extensions:
Since DynaPDF version 3.0.21.56 it is also possible to pass a font file to the function. This makes it
possible to load a specific font file with the same rules as other fonts in a search directory. The file
extension is not used to identify the font format. Resource forks, suitcases and dfont resources are
 

Previous topic: AddFieldToFormAction, AddFieldToHideAction

Next topic: AddHeaderFooter