FieldInstances Object (IFieldInstances Interface)
This object is a collection of field instances. The field instances are fields that occur several times in the form and describe several variants of the same object, such as several telephone numbers or addresses of one person, several table rows of one consignment note, etc. Fields with several instances allows you to link related data and not to use several identical unrelated fields instead.
Any field can have several instances. Their regions can be located at a distance from one another or even on different pages. Field instances have the same properties. See Working with Recognized Data for details.
To access the instances of the certain field, use the Instances property of the corresponding Field object.
The FieldInstances object is a so-called "connectable object". The methods of the FieldInstances object report information about the collection modification through special outgoing interfaces. These interfaces are ICollectionEvents (for C++) and the dispinterface DICollectionEvents (for Visual Basic). It should be noted that Visual Basic users should not care for details of implementing event interfaces, as this development platform provides easy means for handling them.
|Count||Integer, read-only||Stores the number of elements in the collection.|
|Element||Field, read-only||Provides access to a single element of the collection.|
|AddNew||Adds a new element to the collection.|
|Item||Provides access to a single element of the collection.|
|DeleteAt||Removes an element from the collection.|
Working with Connectable Objects