This event is normally fired once for each recognition field, directly after it is interpreted but before it is compared to its match value. The match value string is passed along as a parameter. The only available object is the Field object (current field), which contains the interpreted recognition string.
The status of the field is Complete if there are no interpret errors, or Interpretation error if any characters were uninterpretable.
This event allows the event handler to adjust the interpreted recognition field value according to a priori knowledge of the recognition field and/or the identity of the form. This could be based on external information, a table of possible values, or a trigram table.
To change the interpreted value, set the value string of the current field object.
|
Parameter |
Description |
|
MatchValueStr |
The value of the match string (as set up in the field definition). |
|
Return value |
Description |
|
EV_OK |
Normal return. |
|
EV_OK_ABORT |
No effect— treated the same as EV_OK. |
|
EV_ERROR |
Results in an error message and job termination. |
Could be used to implement active field validations of recognition fields, or when there is a priori knowledge of the identify of the form.
Only fired in the Scan and Interpret module s.
The only "active" objects available in this event are the current recognition field and the current job. (Note: There is no active form definition, form, set definition, set, or field definition.)
This event is only for advanced users.