DynaPDF Manual - Page 220

Previous Page 219   Index   Next Page 221

Function Reference
Page 220 of 860
CheckFieldNames
Syntax:
SI32 pdfCheckFieldNames(
const PPDF* IPDF) // Instance pointer
This function checks all currently defined interactive form fields for invalid duplicate field names.
Use this function if multiple interactive forms were imported. DynaPDF does not check or change
duplicate field names during import. Therefore, check the field names and change invalid names if
necessary before closing the document. If an interactive form contains duplicate field names of fields
with different types, the document will be damaged.
Remarks:
If a form contains invalid duplicate field names, the names must be changed with SetFieldName().
However, if such a field is used in a JavaScript action or by a global JavaScript, the JavaScript(s)
must also be changed to avoid error messages in Adobe's Acrobat.
Global JavaScripts can be accessed with the function GetJavaScript() and changed with the function
ChangeJavaScript(). A JavaScript action can be accessed with the function GetJavaScriptAction() and
changed with the function ChangeJavaScriptAction().
Return values:
The function returns the handle of the first invalid field name that was found, that is a value greater
or equal zero. If no invalid field name was found the return value is -1.
CircleAnnot
Syntax:
SI32 pdfCircleAnnot(
const PPDF* IPDF,
// Instance pointer
double PosX,
// y-coordinate of the annotation
double PosY,
// x-coordinate of the annotation
double Width,
// Width of the annotation
double Height,
// Height of the annotation
double LineWidth,
// Line width of the circle or ellipse
UI32 FillColor,
// Fill color or NO_COLOR. See description
UI32 StrokeColor,
// Stroke color or NO_COLOR. See description
TPDFColorSpace CS,
// Color space of the fill and stroke colors
const char* Author,
// Optional author
const char* Subject, // Optional subject
const char* Comment) // Optional comment
The function draws a circle annotation on the current open page. If the parameters Width and Height
are equal the function draws a circle, an ellipse otherwise. If the annotation should be drawn
without a border, set the parameter LineWidth to zero or StrokeColor to the special constant
NO_COLOR.
 

Previous topic: Return values

Next topic: ClearAutoTemplates, ClearErrorLog, ClearHostFonts