In This Topic ▼

L_ExtractObjects_AddObject

Summary

Adds an object to the list.

#include "l_bitmap.h"

L_LTIMGCOR_API L_INT L_ExtractObjects_AddObject(pData, pTargetList, pObject, pObjectNeighbor, uLocation, pReallocated)

The extracted object's information.

The target list to be modified.

The object to add. This value cannot be null.

Optional object for relative positioning.

The target location for adding. Possible values are:

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.

Pointer to be updated with the new EXOBJ-OBJECT structure managed by pData.

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
- If pObjectNeighbor is null, then pObject is added to the end of the list.
- If pObjectNeighbor is not null, then pObject is added after pObjectNeighbor.
EXOBJ_LOCATION_BEFORE
- If pObjectNeighbor is null, then pObject is inserted at the beginning of the list.
- If pObjectNeighbor is not null, then pObject is inserted before pObjectNeighbor.
EXOBJ_LOCATION_CHILD
1. pObjectNeighbor must not be null.
2. If pObjectNeighbor->pChildren is null, then create a new list.
3. pObject is added to the end of pObjectNeighbor->pChildren.
EXOBJ_LOCATION_SIBLING
1. pObjectNeighbor must not be null.
2. If pObjectNeighbor->pSiblings is null, then create a new list.
3. pObject is added to the end of pObjectNeighbor->pSiblings.

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

Win32, x64, Linux.