L_ExtractObjects_MoveObject (original) (raw)
Summary
Moves the specified object from the current list to the specified list.
Syntax
#include "l_bitmap.h"
L_LTIMGCOR_API L_INT L_ExtractObjects_MoveObject(pData, pSourceList, pObject, pTargetList, pObjectNeighbor, uLocation)
Parameters
pEXOBJ_DATA pData
Pointer to an EXOBJ_DATA structure representing the extracted object's information.
pEXOBJ_OBJECTLIST pSourceList
The source list which contains pObject.
pEXOBJ_OBJECT pObject
Pointer to an EXOBJ_OBJECT structure representing the object to move. This value cannot be null.
pEXOBJ_OBJECTLIST pTargetList
The target list to be modified.
pEXOBJ_OBJECT pObjectNeighbor
Optional object for relative positioning.
L_UINT8 uLocation
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. |
Returns
| Value | Meaning |
|---|---|
| SUCCESS | The function was successful. |
| < 1 | An error occurred. Refer to Return Codes. |
Comments
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
Required DLLs and Libraries
- LTIMGCOR
- For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application
Platforms
Win32, x64, Linux.
See Also
Functions
LEADTOOLS Raster Imaging C API Help