company logo

PropertyHandle :: IsParent - Is property handle parent

The function checks, whether the current property handle is the parent for the property handle passed to the function. Especially for weak-typed or transient reference the function is able to detect, whether the passed property handle is still valid in the application context or not.

Sub-handles for weak-typed parents are automatically updated, when the parent's type changes.

When changing the property handle for a transient property handle, reopen events are generated but subordinated property handles are not updated. Moreover, sub property handles are still valid in the property handle hierarchy, but not in the application context. The function detects this type of inconsistency and allows the application to react.

  if ( !parent.IsParent(my_ph) )

    my_ph.Open(parent,prop_path); // property path is known by the application

Return value:  Return value ( logical  )

The function returns YES when the question was answered positively. Otherwise it returns NO.

Implementation details

logical PropertyHandle  :: IsParent ( PropertyHandle &prop_hdl )
  • prop_hdl - Property Handle

    Is a reference to an (usually) opened property handle.