THPDFPage.BeginOptionalContent Method
Begins the optional content sequence for the page drawing workflow. Keep the returned object or current graphics state balanced with the matching end call before finalizing the page or document
Declaration
procedure BeginOptionalContent(const OCName: AnsiString);
Unit
HPDFDoc
Parameters
| Name | Purpose |
|---|---|
OCName | PDF resource name, packet name, profile name, or caller-defined identifier |
Return value
This member does not return a value
Usage notes
- Use this API in the page drawing 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
- Page-level changes affect subsequent operators on the same page; save and restore graphics state when a temporary setting should not leak