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 used by AddLoadedSignatureField |
Y1 | Input used by AddLoadedSignatureField |
X2 | Input used by AddLoadedSignatureField |
Y2 | Input used by AddLoadedSignatureField |
AFieldName | AcroForm field name or field dictionary targeted by the helper |
Return value
Returns an Integer value
Usage notes
- The field has no signature dictionary, so it is an empty field for a viewer or another signing tool to sign. To sign it with
SignPDFWithPFXorPreparePDFForSigning, create it with AddLoadedSignedSignatureField instead - Use this API in the digital signature and PAdES workflow before the affected page, resource, field, or catalog object is finalized
- Keep object names, field names, resource names, and returned handles stable until the document is finalized
- Reserve 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