API reference › Digital Signatures
pdfCreateSigFieldAP
Create an empty /FT /Sig AcroForm field (the widget a
int32_t __stdcall pdfCreateSigField(PPDF IPDF, const char* Name, int32_t Parent, double PosX, double PosY, double Width, double Height);
int32_t __stdcall pdfCreateSigFieldAP(PPDF IPDF, uint32_t SigField);
function pdfCreateSigField(const IPDF: PPDF; const Name: PAnsiChar; Parent: Integer; PosX, PosY, Width, Height: Double): Integer; stdcall;
function pdfCreateSigFieldAP(const IPDF: PPDF; SigField: Cardinal): Integer; stdcall;
Purpose. Create an empty /FT /Sig AcroForm field (the widget a signature will later be placed into), and give it a visible normal appearance stream (a framed box).
Description. pdfCreateSigField delegates to AddSigField. Ignored parameter: Parent is accepted by the ABI but not passed to AddSigField — consistent with this SDK's broader, repeatedly-confirmed pattern of leaf field creators silently dropping Parent (Field Creation) — hierarchical grouping of signature fields, if needed, requires pdfCreateGroupField (Field Creation) instead. pdfCreateSigFieldAP is a small, real, separate step (per an inline comment: "give signature fields a visible normal appearance (a framed box)") — a signature field created via pdfCreateSigField has no visible appearance until this is called separately.
Parameters.
| Parameter | Description |
|---|---|
IPDF | Document handle. |
Name | Field name. |
Parent | Accepted but dropped — same systemic pattern as the leaf field creators in Field Creation. |
PosX, PosY, Width, Height | Field rectangle. |
SigField | *(AP only)* The target signature field's handle. |
Return value. pdfCreateSigField: the new field's handle; 0 on failure. pdfCreateSigFieldAP: 1 on success, 0 otherwise.
C# (P/Invoke)
public static extern int pdfCreateSigFieldAP(IntPtr IPDF, uint SigField);
Object Creation
pdfCreateSigFieldAP
The …A form takes UTF-8, …W
takes UTF-16; a bare name aliases the ANSI form.
Worked examples — complete programs in ten languages.