In This Topic ▼

L_ExtractObjects_MoveObject

include "l_bitmap.h"

L_LTIMGCOR_API L_INT L_ExtractObjects_MoveObject(pData, pSourceList, pObject, pTargetList, pObjectNeighbor, uLocation)

Moves the specified object from the current list to the specified list.

Pointer to an EXOBJ_DATA structure representing the extracted object's information.

The source list which contains pObject.

Pointer to an EXOBJ_OBJECT structure representing the object to move. This value cannot be null.

The target list to be modified.

Optional object for relative positioning.

The target location for adding. This can be one of the following values:

Value	Meaning
EXOBJ_LOCATION_AFTER	[0] Add pObject to pTargetList after pObjectNeighbor.
EXOBJ_LOCATION_BEFORE	[1] Add pObject to pTargetList before pObjectNeighbor.
EXOBJ_LOCATION_CHILD	[2] Add pObject to the end of pObjectNeighbor->pChildren.
EXOBJ_LOCATION_SIBLING	[3] Add pObject to the end of pObjectNeighbor->pSiblings.

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

The behavior depends on the provided value of _uLocation_:

EXOBJ_LOCATION_AFTER or EXOBJ_LOCATION_BEFORE:
1. pTargetList must not be null
2. Removes the object from the current list
3. Adds to pTargetList using the logic specified in L_ExtractObjects_AddObject
EXOBJ_LOCATION_CHILD or EXOBJ_LOCATION_SIBLING
1. pTargetList must be null
2. Removes the object from the current list
3. Adds the object using the logic specified in L_ExtractObjects_AddObject