THotPDF.RegisterOptionalContentGroup Method
Registers a reusable optional content group resource for the document creation workflow. Call it before page commands reference the resource name so color, pattern, font, image, or profile data is available in the PDF resource tree
Declaration
function RegisterOptionalContentGroup(const LayerName: AnsiString; VisibleByDefault: boolean= True; UserToggleAllowed: boolean= True): AnsiString;
Unit
HPDFDoc
Parameters
| Name | Purpose |
|---|---|
LayerName | PDF resource name, packet name, profile name, or caller-defined identifier |
VisibleByDefault | Input used by RegisterOptionalContentGroup |
UserToggleAllowed | Input used by RegisterOptionalContentGroup |
Return value
Returns an AnsiString value
Usage notes
- Use this API in the document creation workflow before the affected page, resource, field, or catalog object is finalized
- Keep object names, field names, resource names, and returned handles stable until the document is finalized