AddActionNextWebA

Annotations and hotspot links

Description

The trailing A denotes the ANSI (char) DLL entry point; the ActiveX/COM surface exposes only the Unicode form. Behaviour is identical to AddActionNextWeb and string arguments are interpreted using the current SetAnsiMode code page

Appends a URI next-action to an existing annotation, outline, or form-field action

Syntax

Delphi

Function DLAddActionNextWebA(InstanceID, ActionID: Integer; Link: PAnsiChar): Integer;

DLL

int DLAddActionNextWebA(int InstanceID, int ActionID, const char * Link);

Parameters

ActionIDAn ActionID as returned by GetAnnotActionID, GetOutlineActionID, or GetFormFieldActionID
LinkThe target URI for the chained action

Return values

0The ActionID was invalid or the link string was empty
1The URI next-action was appended successfully

Remarks

The function writes the PDF action /Next entry without replacing the primary action, preserving any existing chained actions

Use SetActionURL to replace the URI of the primary action, and use AddActionNextWeb when the URI must run after the primary action