This function returns a handle to the property that is the 'index'-th property
of influence on the form. It also returns the handle to instance this property
belongs to.
Note: the returned property is always a datatypeProperty
Note: if input is incorrect (for example index is in wrong domain) _property and
instance will be both zero.
Note: BE AWARE, THIS FUNCTION EXPECTS A TREE, NOT A NETWORK, IN CASE OF A NETWORK THIS FUNCTION CAN LOCK THE ENGINE
Syntax
//
// Strong typing definition
//
void GetDependingProperty(
OwlInstance baseOwlInstance,
ConceptualFace conceptualFace,
int64_t index,
OwlInstance * owlInstance,
OwlDatatypeProperty * owlDatatypeProperty
);
//
// Weak typing definition
//
void __declspec(dllexport) __stdcall GetDependingProperty(
int64_t baseOwlInstance,
int64_t conceptualFace,
int64_t index,
int64_t * owlInstance,
int64_t * owlDatatypeProperty
);
Property baseOwlInstance
Size: 64 bit / 8 byte (value)
The handle to the specific (base) instance in the design tree. The instance handle is static within one open model but is most probably different when the same instance is opened in another model. The instance is always exactly of one unique class.
Property conceptualFace
Size: 64 bit / 8 byte (value)
A conceptual face is a face that does not have to be placed within one plane. For example a Cylinder has typically 3 conceptual faces where a Box typically has 6 conceptual faces. In case of a Box the 'normal' face count is equal to the conceptual face count, in case of a Cylinder the 'normal' face count depends on the segmentation, for example in case of 36 segments, it will have 38 faces but still 3 conceptual faces.
Property index
Size: 64 bit / 8 byte (value)
This is the index (0 based) of the depending property available for this specific conceptual face.
Property owlInstance
Size: 64 bit / 8 byte (reference)
The handle to the specific instance in the design tree. The instance handle is static within one open model but is most probably different when the same instance is opened in another model. The instance is always exactly of one unique class.
Property owlDatatypeProperty
Size: 64 bit / 8 byte (reference)
This attribute represents a handle to the datatype property (attribute). The handle will be static during the life-time of the model, when the model (or part of it) is saved and opened again, the handle will most probably be different.