THPDFPage.AddScreenAnnotation Method
Adds screen annotation data to the page drawing workflow. The call creates or attaches the PDF-side object needed by later output, validation, signing, or page rendering steps
Declaration
function AddScreenAnnotation(Rectangle: TRect; const Contents: AnsiString= ''; Color: TColor= clBlack): THPDFDictionaryObject;Unit
HPDFDoc
Parameters
| Name | Purpose |
|---|---|
Rectangle | Page area or widget rectangle where the operation is applied |
Contents | Human-readable text stored in the PDF object, action, annotation, or structure element |
Color | Color component or color value used by the painting or resource operation |
Return value
Returns a THPDFDictionaryObject value
Usage notes
- Use this API in the page drawing workflow before the affected page, resource, field, or catalog object is finalised
- Keep object names, field names, resource names, and returned handles stable until the document is finalised
- Page-level changes affect subsequent operators on the same page; save and restore graphics state when a temporary setting should not leak