Ema_Object_Move_Recursively()
Abstract
Moves the specified object and all of its sub-objects from the source model into the destination model.
Syntax
Ema_Object_Move_Recursively (src_model_id, object_id, dst_model_id)
| Argument | Type | Description |
|---|---|---|
src_model_id |
EmaT_Model_Id |
numeric model ID of the model that originally contains the specified object [This value is a numeric identifier that references a model. Use the functions Ema_Model_Create(), Ema_Model_Copy(), or Ema_Model_Read() to obtain a model ID.] |
object_id |
EmaT_Object_Id |
numeric object ID of the object to be moved [This value is a numeric identifier that references an object. An object ID can be obtained from the functions Ema_Object_Create(), Ema_Object_Copy(), Ema_Object_Move(), Ema_Object_Move_Recursively(), or Ema_Object_Nth().] |
dst_model_id |
EmaT_Model_Id |
numeric model ID of the model to which the specified object will be moved |
Return Type
EmaT_Object_Id
numeric object ID of the moved object within the destination model
Header
ema.h
Details
This function works like Ema_Object_Move(), except that it also moves all sub-objects of the specified object.
Because "properties" objects will be moved as well, this function should only be used with Ema_Props_Sharing_Set (VOSC_FALSE) and Ema_Equal_Props_Sharing_Set (VOSC_FALSE). If the properties are shared, they should be replicated instead of moved.