BECOMESPRIMARY keyword

Applies To

Data binding of subcollection-bound grid components.

Collection specifications with the OBJECTn keyword.

Description

Specifies that when a subcollection or a secondary collection is the current collection, operations on it, such as Navigate, function as they would for the primary collection.

Syntax

BECOMESPRIMARY( )

Remarks

The BECOMESPRIMARY keyword is rarely needed. When a primary collection is navigated, validations are performed not only on components bound to that collection but on nonstandard bound components as well. Also, a set of events for getting and loading the values from nonstandard bound components is generated. Operations on secondary collections and subcollections do not have similar results on nonstandard bound components. The BECOMESPRIMARY( ) keyword specifies that the behavior of a nonprimary collection is similar to the primary collection when it is navigated.