THPDFPage.AddCertificationSignatureField Method
Creates a signature field and makes it the document certification signature by attaching a DocMDP transform with the requested permission level
Declaration
procedure AddCertificationSignatureField(const FieldName: AnsiString; Rectangle: TRect; Permission: THPDFDocMDPPermission; ContentsBytes: Integer= 8192; const SubFilter: AnsiString= 'adbe.pkcs7.detached'; const Reason: AnsiString= ''; const Location: AnsiString= ''; const ContactName: AnsiString= ''; Flags: THPDFFormFieldFlags= []);Unit
HPDFDoc
Parameters
| Name | Purpose |
|---|---|
FieldName | AcroForm field name or field dictionary targeted by the helper |
Rectangle | Page area or widget rectangle where the operation is applied |
Permission | DocMDP permission granted to changes made after certification |
ContentsBytes | Number of binary signature bytes reserved in the hexadecimal /Contents placeholder |
SubFilter | Signature subfilter stored in the signature dictionary |
Reason | Optional signing reason stored with the signature |
Location | Optional signing location stored with the signature |
ContactName | Optional signer contact information stored with the signature |
Flags | AcroForm widget flags applied to the signature field |
Return value
This member does not return a value
Usage notes
- Call this method before preparing the output for external signing
- A document can have only one certification signature, but it can also contain later approval signatures permitted by the selected DocMDP level
- Choose
ContentsByteslarge enough for the final CMS container because signing fails if the hexadecimal payload exceeds the reserved space