AddActionNextEx
Annotations and hotspot links, Form fields
Description
Appends a next-action to an existing action handle by selecting the action kind with a named builder constant
Syntax
Delphi
Function TPDFlib.AddActionNextEx(ActionID, ActionKind: Integer; Const Value, FieldNames: WideString; Flags, DestID: Integer): Integer;Parameters
| ActionID | An action handle returned by an annotation, outline, open-action, or form-field action helper |
|---|---|
| ActionKind | One of PDF_ACTION_BUILDER_WEB, PDF_ACTION_BUILDER_NAMED, PDF_ACTION_BUILDER_JAVASCRIPT, PDF_ACTION_BUILDER_HIDE, PDF_ACTION_BUILDER_SUBMIT, PDF_ACTION_BUILDER_RESET, PDF_ACTION_BUILDER_IMPORTDATA, or PDF_ACTION_BUILDER_DESTINATION |
| Value | The URI, named action, JavaScript source, import-data file name, or unused value for destination actions |
| FieldNames | A comma-separated field list for hide, submit, and reset actions |
| Flags | Action-specific submit or reset flags, or the hide flag for visibility actions |
| DestID | The destination handle for PDF_ACTION_BUILDER_DESTINATION |
Return values
| 0 | The action handle, action kind, or required value was invalid |
|---|---|
| 1 | The next-action was appended successfully |
Remarks
The helper reuses the same internal action construction path as the action-specific AddActionNext* methods, so PDF/A restrictions and action introspection remain consistent