Kofax DOKuStar Validation - Manual (Page 42)

DOKuStar Validation Programming Manual Page • 38
Sub-field Events
Sub-fields (e.g. table cells) have their own activation and deactivation events: OnSubFieldActivating ,
OnSubFieldActivated , OnSubFieldDeactivating and OnSubFieldDeactivated .
These events get the Field (e.g. table), the Subfield (the cell), and the next (or previous respectively) sub-field as
parameters.
Definitions:
Private Sub fld_OnSubFieldActivated(ByVal Field As Field, ByVal SubField As Field, ByVal
PreviousSubField As Field)
Private Sub fld_OnSubFieldDeactivated(ByVal Field As Field, ByVal SubField As Field, ByVal
NextSubField As Field)
Here, fld is expected to be set to the table field.
There is no ... Changed event for sub-fields. This is unnecessary because every change in a sub-field will result in
an OnFieldChanged event for the field itself, delivering both the field and the sub-field as parameters.
OnFieldDataSourceChanged
These events result when the DataSource (i.e. the image) of the field changes. This may happen in several
situations:
- The user chooses a DOKuStar alternative for the field, which is on a different page of the document
- The user splits a document: field contents may be emptied, thus losing their image
- The user moves pages from one document to another: again fields may be emptied, thus losing their image
Definition:
Private Sub fld_OnFieldDataSourceChanged(ByVal Field As Field, ByVal DataSource As DataSource,
ByVal PreviousDataSource As DataSource)
Parameters are the Field , and the old and the new data source.