company logo

PropertyHandle :: SetArea - Set area pointer for property instance

The function can be used for property handles referring to internal data (transient fields) to allocate an instance area. The data area is not owned by the property handle in this case and will not automatically freed when closing the property handle.

Do not use this functions for subordinated property handles that refer to properties in instances. This will disconnect the property handle from its instance data.

Return value:  Instance area ( ::Instance  )

Instances do have the type of the referenced property handle (collection type). The instance contains a pointer to a properly structured instance area.

You can use the !-operator or the GetData() function to check whether the instance refers to data or not.

Implementation details

::Instance PropertyHandle  :: SetArea ( void *datarea, logical w_owner=NO )
  • datarea - Data area
  • w_owner - - internal feature (not documented) Default: NO