Events for the fieldtype object, Onfieldactivated, Onfieldchanged – Kofax DOKuStar Validation User Manual

Page 23

Advertising
background image

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.

Advertising