PropertyHandle :: GetInitInstance - 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 with the SetType() function. Calling the function for an attribute will return an initialized attribute instance.

When the property handle has selected an instance the current selection is canceled ( after saving changes made to the selected instance). One may fill attributes and initialize single references but one 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.