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, PDF_ACTION_BUILDER_DESTINATION, PDF_ACTION_BUILDER_REMOTE_DESTINATION, PDF_ACTION_BUILDER_LAUNCH, or PDF_ACTION_BUILDER_THREAD |
| 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 flags or the 1-based thread index for PDF_ACTION_BUILDER_THREAD |
| DestID | The destination handle for PDF_ACTION_BUILDER_DESTINATION, or a 1-based bead index for PDF_ACTION_BUILDER_THREAD with 0 selecting the first bead |
Return values
| 0 | The action handle, action kind or required value was invalid, or PDF/X-6 mode rejects the selected unsafe action kind |
|---|---|
| 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 and PDF/X-6 restrictions and action introspection remain consistent
Thread actions use indirect references to an existing article thread and bead, so
Value and FieldNames are ignored for PDF_ACTION_BUILDER_THREAD