PropertyHandle :: GetInitArea - Provide initialized instance area

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.

For storing the instance to the database one has to call the Add() function for the property handle. Changes made to the instance are not saved automatically when changing the selection for the property handle. Since no instance is selected in the property handle after GetInitArea() one cannot assign values to subordinated property handles.