Ovis_Layer_Parent_Set()
Abstract
Specifies the parent of an Ovis layer.
Syntax
Ovis_Layer_Parent_Set (layer_ptr, parent_ptr)
| Argument | Type | Description |
|---|---|---|
layer_ptr |
OvisT_Layer * |
Ovis layer |
parent_ptr |
OvisT_Layer * |
Ovis parent layer |
Return Type
OvisT_Compcode
OvisC_Compcode_Success if the parent can be set; OvisC_Compcode_Failure otherwise.
Header
ovis_layer.h
Details
This function accesses the layer hierarchy and specifies the parent of the Ovis layer in the hierarchy.
Example
OvisT_Layer * parent, * child;
/* …child and parent created elsewhere */
Ovis_Layer_Parent_Set (child, parent);
Errors
- Child layer is NIL.
Reference
- Use the function Ovis_Layer_Parent_Get() to get the parent layer of a layer.
- Use the function Ovis_Layer_Child_Layer_Count() to get the number of child layers of a layer.
- Use the function Ovis_Layer_Child_Layer_Nth() to get one child layer of a layer.