DynaPDF Manual - Page 581

Previous Page 580   Index   Next Page 582

Function Reference
Page 581 of 787
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
PlaceSigFieldValidateIcon
Syntax:
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().
Remarks:
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.
 

Previous topic: PlaceImage

Next topic: PlaceTemplate

Start Chat