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.

Properties

Name Type Description
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.

Methods

Name Description
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.

Related objects

See also

Working with Recognized Data

Field

Working with Collections

ICollectionEvents

Working with Connectable Objects

Working with Properties

15.08.2023 13:19:30

Usage of Cookies. In order to optimize the website functionality and improve your online experience ABBYY uses cookies. You agree to the usage of cookies when you continue using this site. Further details can be found in our Privacy Notice.