DynaPDF Manual - Page 304

Previous Page 303   Index   Next Page 305

Function Reference
Page 304 of 839
// The entire PDF file should be submitted to our web server.
act = pdfCreateSubmitAction(pdf,sfPDF,"http://www.test.com/pdf.php");
pdfAddActionToObj(pdf, otField, oeOnMouseUp, act, btn);
pdfEndPage(pdf);
pdfCloseFile(pdf);
pdfDeletePDF(pdf);
printf("PDF file %s successfully created!\n", outFile);
return 0;
}
Remarks:
The height of a signature field should be large enough to display at least 3 lines of text. If the
optional strings "Location" and "Reason" of the function CloseAndSignFile() should be set, set the
field height to a value so that up to 5 lines of text can be drawn into the field. The resulting font size
depends on the height of the field divided by the number of text lines.
Interactive form fields can be structured into several groups by passing a handle of a group field to
the parameter Parent. See CreateGroupField() for further information.
Return values:
If the function succeeds the return value is the field handle, a value greater or equal zero. If the
function fails the return value is a negative error code.
CreateSigFieldAP
Syntax:
SI32 pdfCreateSigFieldAP(
const PPDF* IPDF) // Instance pointer
UI32 SigField)
// Handle of a signature field
The function creates a signature appearance template in the exact size of the base signature field.
The created template is already opened if the function succeeds and you can draw arbitrary contents
into it. After the appearance has been defined the template must be closed with EndTemplate().
Note that the template is reserved for the signature field. It must not be placed on pages or other
templates.
When creating a user defined appearance for a signature field you should also place the validation
icon properly so that it does not overprint the entire contents. See also PlaceSigFieldValidateIcon().
Remarks:
An example application that demonstrates the creation of a user defined signature appearance is
delivered with DynaPDF (see example signature_ap).
Return values:
If the function succeeds the return value is the action handle, a value greater or equal zero. If the
function fails the return value is a negative error code.
 

Previous topic: CreateSigField, How to lock an Interactive Form after signing?

Next topic: CreateSoftMask, Soft mask types