Ema_Object_Move()
Abstract
Moves the specified object from the source model into the destination model.
Syntax
Ema_Object_Move (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 implements the move operator for objects. Once moved into the destination model, the specified object is assigned a new object ID, which will generally be different than its original ID (the new object ID is returned as the value of this function).
This function moves only the specified object. To move the object and all of its sub-objects, use Ema_Object_Move_Recursively().