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

Reopen any property
Property :: reopen ( cObjectSpace, cParentProperty )
Reopen top property
Property :: reopen ( cObjectSpace )
Reopen sub property
Property :: reopen ( cParentProperty )

Implementation details

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.

to list

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.

to list

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.

to list

to top Comment