Xojo Conferences

DynaPDF Manual - Page 566

Previous Page 565   Index   Next Page 567

Function Reference
Page 566 of 770
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().
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
Templates can be used multiple times on different pages or positions and with different sizes. Unlike
images, a template can be scaled without losing quality as far as the template contains vector
graphics and text objects only.
The calculation of the width and height is the same as for images:

Previous topic: PlaceImage

Next topic: PlaceTemplateEx