THPDFPage.AddPushButtonWithMovieAction Method
Adds push button with movie action data to the AcroForm workflow. The call creates or attaches the PDF-side object needed by later output, validation, signing, or page rendering steps
Declaration
procedure AddPushButtonWithMovieAction(const FieldName, Caption: AnsiString; ButtonRect: TRect; MovieAnnot: THPDFDictionaryObject; Operation: THPDFMovieOperation= moPlay; Flags: THPDFFormFieldFlags= []);Unit
HPDFDoc
Parameters
| Name | Purpose |
|---|---|
FieldName | AcroForm field name or field dictionary targeted by the helper |
Caption | Human-readable text stored in the PDF object, action, annotation, or structure element |
ButtonRect | Input used by AddPushButtonWithMovieAction |
MovieAnnot | Input used by AddPushButtonWithMovieAction |
Operation | Input used by AddPushButtonWithMovieAction |
Flags | Input used by AddPushButtonWithMovieAction |
Return value
This member does not return a value
Usage notes
- Use this API in the AcroForm 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