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
- Use this API in the digital signature and PAdES workflow before the affected page, resource, field, or catalog object is finalised
- Keep object names, field names, resource names, and returned handles stable until the document is finalised
- 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