Try OpenEdge Now
skip to main content
ABL Reference
Handle Attributes and Methods Reference : NUM-ITERATIONS attribute (data objects)
 

NUM-ITERATIONS attribute (data objects)

Indicates how many levels deep you are in a recursive FILL of a ProDataSet.
Data type: INTEGER
Access: Read-only
Applies to: Buffer object handle
As a recursive ProDataSet FILL is proceeding, it creates clones of the relevant buffers, relations, queries and data-sources for each level of recursion. As a new record is added to the ProDataSet, it fires FILL events on the recursed, cloned buffer. From inside the event handler, you may want to see previous iterations of the buffer, its parent, grandparent, great-grandparent, and so on. NUM-ITERATIONS indicates the level of the recursion.
If the buffer object handle does not point to a ProDataSet temp-table or is not part of a recursive data-relation, NUM-ITERATIONS returns the Unknown value (?).

See also

ADD-PARENT-ID-RELATION( ) method, CURRENT-ITERATION attribute (DataObjects), DEFINE DATASET statement, GET-ITERATION( ) method (Data Objects), RECURSIVE attribute