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
| Index | The 1-based form-field index |
|---|---|
| TriggerEvent | The trigger name to clear: empty for the primary /A action, or E, X, D, U, Fo, Bl, K, F, V, or C |
Return values
| 0 | No matching field action was removed |
|---|---|
| 1 | The 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