API referenceDigital Signatures

pdfCreateSigFieldAP

Create an empty /FT /Sig AcroForm field (the widget a

C
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);
Delphi
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.

ParameterDescription
IPDFDocument handle.
NameField name.
ParentAccepted but dropped — same systemic pattern as the leaf field creators in Field Creation.
PosX, PosY, Width, HeightField 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)

wrappers/dotnet/LumasPdf.cs
public static extern int pdfCreateSigFieldAP(IntPtr IPDF, uint SigField);
Area
Digital Signatures
Category

Object Creation

Exported names

pdfCreateSigFieldAP

String variants

The …A form takes UTF-8, …W takes UTF-16; a bare name aliases the ANSI form.

See working code

Worked examples — complete programs in ten languages.