THotPDF.AddLoadedSignatureField Method
Adds loaded signature field data to the digital signature and PAdES workflow. The call creates or attaches the PDF-side object needed by later output, validation, signing or page rendering steps
Declaration
function AddLoadedSignatureField(PageIndex: Integer; X1, Y1, X2, Y2: Single; const AFieldName: AnsiString): Integer;Unit
HPDFDoc
Parameters
| Name | Purpose |
|---|---|
PageIndex | Zero-based index or object index used to select an existing item |
X1 | Input supplied to AddLoadedSignatureField |
Y1 | Input supplied to AddLoadedSignatureField |
X2 | Input supplied to AddLoadedSignatureField |
Y2 | Input supplied to AddLoadedSignatureField |
AFieldName | AcroForm field name or field dictionary targeted by the helper |
Return value
Returns an Integer value
Usage notes
- The field carries no signature dictionary, so a viewer or another signing tool sees an empty field awaiting a signature. To sign it with
SignPDFWithPFXorPreparePDFForSigning, create it with AddLoadedSignedSignatureField rather than this method - Use this API in the digital signature and PAdES workflow before the affected page, resource, field or catalogue object is finalised
- Keep object names, field names, resource names and returned handles stable until the document is finalised
- Set aside signature space before inserting external CMS or timestamp bytes, and keep byte ranges stable after preparation
- Loaded-document object references may be indirect; resolve arrays, dictionaries or streams before inspecting nested values