RemoveFormFieldActionA

Form fields, 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 RemoveFormFieldAction and string arguments are interpreted using the current SetAnsiMode code page

Removes the action assigned to a form-field trigger

Syntax

Delphi

Function DLRemoveFormFieldActionA(InstanceID, Index: Integer; TriggerEvent: PAnsiChar): Integer;

DLL

int DLRemoveFormFieldActionA(int InstanceID, int Index, const char * TriggerEvent);

Parameters

IndexThe 1-based form-field index
TriggerEventThe trigger name to clear: empty for the primary /A action, or E, X, D, U, Fo, Bl, K, F, V, or C

Return values

0No matching field action was removed
1The requested field action was removed

Remarks

When TriggerEvent is U, the function clears both the primary /A action and any additional /AA /U action so older and newer mouse-up action forms are removed together

When the final additional action is removed, the empty /AA dictionary is removed from the field dictionary