DynaPDF Manual - Page 623

Previous Page 622   Index   Next Page 624

Function Reference
Page 623 of 839
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
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:
If Width or Height is -1 the function uses the mirrored original width or height from the
If Width or Height is 0, the missing value is calculated in relation to the given value of Height
or Width to preserve the template's aspect ratio. The resulting output is a template with exact
proportions relative to its original size.

Previous topic: PlaceImage, PlaceSigFieldValidateIcon

Next topic: PlaceTemplateEx