`pdfCreateGroupField`

Create a non-terminal field-tree grouping node (/T with

int32_t __stdcall pdfCreateGroupField(PPDF IPDF, const char* Name, int32_t Parent);

Delphi

function pdfCreateGroupField(const IPDF: PPDF; const Name: PAnsiChar; Parent: Integer): Integer; stdcall;

Purpose. Create a non-terminal field-tree grouping node (/T with no /FT/widget of its own, existing purely to organize child fields hierarchically — e.g. for shared /DA inheritance or grouped export under a common fully-qualified name).

Description. The one function in this chapter where Parent is genuinely honored — CreateGroupFieldH accepts and uses it, unlike every leaf-field creator above.

Parameters.

Parameter	Description
`IPDF`	Document handle.
`Name`	The group's partial field name segment.
`Parent`	Genuinely honored — the new group's parent field handle (or a root sentinel for a top-level group).

Return value. The new group field's handle; 0 if IPDF is invalid.

C# (P/Invoke)

wrappers/dotnet/LumasPdf.cs

public static extern int pdfCreateGroupField(IntPtr IPDF, [MarshalAs(UnmanagedType.LPStr)] string Name, int Parent);

Area

Forms