DynaPDF Manual - Page 571

Previous Page 570   Index   Next Page 572

Function Reference
Page 571 of 777
LBOOL pdfPlaceSigFieldValidateIcon(
const PPDF* IPDF, // Instance pointer
UI32 SigField,
// Handle of a signature field
double PosX,
// X-Coordinate of the icon
double PosY,
// Y-Coordinate of the icon
double Width,
// Icon width
double Height)
// Icon height
The function places the validation icon within a signature field to the wished position. By default, the
validation icon is scaled to the width or height of the signature field and it is horizontally and
vertically centered. When creating a user defined appearance for a signature field it is sometimes
required to place the validation icon on another position within the signature field so that no
important contents will be overdrawn.
The unscaled size of the validation icon is 100 x 100 units. It can be scaled to every size you want but
it is usually best to preserve the aspect ratio. The icon should normally be placed fully inside the
signature field. If the validation icon should not be shown then place it outside the signature field.
The demo package of DynaPDF contains the project signature_ap that demonstrates the usage of the
function as well as the creation of a user defined signature appearance. See also CreateSigFieldAP().
Please note that the position of the validation icon is no property that can be stored in the PDF file.
The position and size that you set with this function can only be considered if the file will be signed
later with DynaPDF (see CloseAndSignFile(), CloseAndSignFileEx(), or CloseAndSignFileExt() for
further information).
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
LBOOL pdfPlaceTemplate(
const PPDF* IPDF,
// Instance pointer
SI32 TmplHandle,
// Template handle
double PosX,
// X-Coordinate
double PosY,
// Y-Coordinate
double ScaleWidth,
// Scaled width
double ScaleHeight) // Scaled height
The function places a template on a page, another open template, or pattern. The parameter
TmplHandle must be a valid template handle that was returned by BeginTemplate(), ImportPage() or

Previous topic: PlaceImage

Next topic: PlaceTemplateEx