Kofax DOKuStar Validation - Manual (Page 23)

DOKuStar Validation for Ascent Capture Page • 19
Events for the FieldType Object
OnFieldActivated
This event will be fired when a field gets activated, either by keyboard entry, mouse click or by the scripting code
itself.
Definition:
Private Sub fld_OnFieldActivated(ByVal Field As Field, ByVal PreviousField As Field)
The parameter Field is the field that gets activated, PreviousField is the field that gets deactivated.
When you return False in the OnFieldActivating, always the next field will be activated automatically.
OnFieldChanged
This event will be fired when the contents of a field changed. This happens when the user enters data, but also when
a field’s value is changed by another scripting routine. Be aware of this to avoid cycles in the code!
Definition:
Private Sub fld_OnFieldChanged(ByVal Field As Field, ByVal SubField As Field)
The parameter Field is the field itself. SubField may point to a sub-field of the Field ; e.g. a cell of a table is a
sub-field of the table field. For more information, see chapter Tables below.
The event will only be fired if the data really changes; if the user just steps through the fields without changes, the
event will not be triggered.
If the user again types in the same contents as before, the event will also not be triggered.
If you return False in the OnFieldChanging event, the old contents of the field (before the user did any typing)
will be restored. See the How Do I… section on how to change this behavior.
Field.Value always contains what the user typed in. The original contents of the field can be seen in the
OnFieldChanging event in the additional VerifyEventArgs parameter.