company logo

Property :: reopen - Reopen property

Some properties may change the cursor when changing selection for the parent instance. This may happen for untyped and weak-typed parents, but also for transient references.

Sub properties for untyped and weak-typed collections are handled by the system, which automatically reopens the property handle, when the type of instance in the parent property has changed.

Transient properties, which are set by the application, must be handled by the application, i.e. when reopening a transient property becomes necessary, the application may call reopen() explicitly. Another way of checking the validity of the property handle is calling validateForParent().
Notes:

The function does not maintain filter settings or current access key, i.e. the application has to set those properties when not referring to standards.

Implementation overview

Implementation details

  1. Reopen any property
    Property  :: reopen ( odaba::ObjectSpace &cObjectSpace, odaba::Property &cParentProperty )

    The function reopens the property for the object handle passed in cObjectSpace or parent property passed in cParentProperty. Usually, top or extent properties require an object space handle for reopen, sub properties a parent property. In some cases, the application is not able to decide, whether to reopen a top or a sub property, in which case both parameters can be passed.
    • cObjectSpace - Object space reference

      The reference refers to an opened or not opened object space handle.
    • cParentProperty - Parent property handle

      The property handle refers to the next higher property.

    2. to list
  2. Reopen top property
    Property  :: reopen ( odaba::ObjectSpace &cObjectSpace )

    In order to reopen a top (extent) property handle, a valid object space handle has to be passed to passed in cObjectSpace.
    • cObjectSpace - Object space reference

      The reference refers to an opened or not opened object space handle.
    3. to list
  3. Reopen sub property
    Property  :: reopen ( odaba::Property &cParentProperty )

    In order to reopen a sub property, a valid parent property handle has to be passed in cParentProperty.
    • cParentProperty - Parent property handle

      The property handle refers to the next higher property.

    4. to list
to top previous next upper table of contents Comment