THPDFPage.AddPushButtonWithNextAction Method
Adds push button with next 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 AddPushButtonWithNextAction(const FieldName, Caption, Param: AnsiString; Rectangle: TRect; ActionType: THPDFButtonAction; const NextParam: AnsiString; NextActionType: THPDFButtonAction; 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 |
Param | Input used by AddPushButtonWithNextAction |
Rectangle | Page area or widget rectangle where the operation is applied |
ActionType | Input used by AddPushButtonWithNextAction |
NextParam | Input used by AddPushButtonWithNextAction |
NextActionType | Input used by AddPushButtonWithNextAction |
Flags | Input used by AddPushButtonWithNextAction |
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