THPDFPage.SetAnnotationAdditionalAction Method

Installs an annotation additional action from a THPDFActionBuilder under the annotation /AA dictionary

Declaration

procedure SetAnnotationAdditionalAction(Annot: THPDFDictionaryObject; Trigger: THPDFAnnotationActionTrigger; Action: THPDFActionBuilder);

HPDFDoc

Name	Purpose
`Annot`	Annotation dictionary returned by the most recent annotation creation call or another annotation lookup
`Trigger`	Additional-action trigger, such as mouse enter, mouse exit, mouse down, mouse up, set focus, or lost focus
`Action`	Action chain built with `THPDFActionBuilder`

The method replaces any existing action for the same trigger key and keeps other /AA entries unchanged
Use ClearAnnotationAdditionalAction to remove one annotation additional-action entry without rebuilding the annotation dictionary
THPDFActionBuilder.ThenAction chains are preserved under the emitted /Next entry
Mouse and focus triggers use /E, /X, /D, /U, /Fo, and /Bl
Page-open, page-close, page-visible, and page-invisible triggers use /PO, /PC, /PV, and /PI and require PDF 1.5
PDF/A and PDF/X restrictions are enforced by the builder when JavaScript, SubmitForm, Launch, or other restricted action types are used
Use SetAnnotationJavaScriptAction for the JavaScript-only convenience path