FieldInterpreted() As Long

Description

This event is normally fired once for each field, directly after it is interpreted.

If you want to reinterpret the field, use the SetReturnValue method. Each time you use the SetReturnValue method with the arguments (0, "Y") in this event, the field is interpreted again. Each time the field is interpreted, the FieldInterpret and FieldInterpreted events are fired. The new interpretation results becomes the field value unless you change the field value yourself.

Each time the Field is interpreted, the original image is used. If you do not use the FieldInterpret event to change the FieldDefinition (the format) and/or enhance the image before reinterpretation, the result will be the same.

FORMS does not keep track of the various interpretation results. You may want to do this using the VBA code, and possibly choose the best result and update the field with the most correct value.

You must also keep track of how many times the field is reinterpreted. The maximum number of times a field can be reinterpreted is 99.

If you do not want to reinterpret the field, return EV_OK (not using SetReturnValue at all, or with the arguments 0 and "N").

Parameters

None.

Return values

Return value

Description

EV_OK

Normal return.

EV_OK_ABORT 

No effect— treated the same as EV_OK.

EV_ERROR

Causes an error message and job termination.

Suggested usage

Could be used to implement active field validations and/or reinterpret the field.

Remarks

Only fired in the Scan and Interpret module s.

Matrix fields cannot be reinterpreted. Return EV_OK (not using the SetReturnValue at all, or with the arguments 0 and "N").

Field statistics indicate how many characters are interpreted, including reinterpretations.

A field can be reinterpreted up to 99 times.

Field-level events