Property :: initializeInstance - Provide initialized instance

The function provides an initialized instance of the type defined for the property handle. For weak-typed collection the type depends on the last type accessed by the property handle or the type set by calling setType(). Calling the function for an attribute will return an initialized attribute instance.

When the property handle has selected an instance the current selection is reset ( after saving changes made to the selected instance). The instance is not yet added to the database. The property handle is selected, but not positioned and not located.

You may fill attributes and initialize single references but you cannot add instances to collections in an initialized instance.

The instance can be stored to the database by calling the save() function for the property handle. Changes made to the instance are saved automatically when changing the selection for the property handle. To avoid storing the instance to the database it must be explicitly canceled (cancel()).

When the property cannot select an initialized instance (read only access, parent property not selected), the function throws an error.