GetFormFieldActionIDA

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 GetFormFieldActionID and string arguments are interpreted using the current SetAnsiMode code page

Returns an ActionID for the specified form field which can be used with the various action manipulation functions such as GetActionType, GetActionDest, GetActionURL and SetActionURL.

There are different trigger events and each trigger's action is distinct.

Syntax

Delphi

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

DLL

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

Parameters

IndexThe index of the form field to work with. The first form field has an index of 1.
TriggerEventRetrieve the action for the specified trigger event: Empty string = simple activation action E = annotation enter action X = annotation exit action D = annotation button down action U = annotation button up action Fo = annotation input focus action Bl = annotation input blur (opposite of focus) action PO = annotation page open action PC = annotation page close action PV = annotation page visible action PI = annotation page invisible action K = form field change action F = form field format action V = form field validate action C = form field calculate action

Return values

0The field index was invalid or the field does not have an action associated with the specified trigger event
Non-zeroThe form field's ActionID for the specified trigger event