LMarker::SetHandle

#include "ltwrappr.h"

virtual L_INT LMarker::SetHandle(phMarker, bFreePrev)

HANDLE * phMarker;

/* handle to a marker collection */

L_BOOL bFreePrev;

/* flag that indicates whether to free the previous marker */

Attaches a new LEAD marker handle to the LMarker class object

Parameter

Description

phMarker

Pointer to a LEAD marker handle that references the marker collection to be attached to this object. This pointer will be invalidated if the function is successful. Pass NULL if you only want to detach the current marker handle from the marker collection.

bFreePrev

Flag that indicates whether to free the previous marker handle before attaching the new one. Possible values are:

 

Value

Meaning

 

TRUE

Free the previous marker handle before attaching the new one.

 

FALSE

Do not free the previous marker handle before attaching the new one.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Use this function to attach a new LEAD marker handle to this LMarker class object's marker collection.

Required DLLs and Libraries

LTFIL

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

LMarker::Copy, LMarker::Create, LMarker::Delete, LMarker::DeleteIndex, LMarker::Enum, LMarker::EnumMarkersCallBack, LMarker::Free, LMarker::GetCount, LMarker::GetHandle, LMarker::GetGlobalMarkers, LMarker::Insert, LMarker::Load, LMarker::SetAsGlobalMarkers, LFile::WriteMetaData, Class Members

Topics:

Raster Image Functions: Markers

 

Working with Markers

Example

L_INT LMarker__SetHandleExample()
{
   L_INT nRet;
   LMarker MyMarker;
   HANDLE SomeMarkerHandle;
   nRet = MyMarker.Load(TEXT("%UserProfile%\\My Documents\\LEADTOOLS Images\\bitmap1.jpg"), 0);
   if(nRet != SUCCESS)
      return nRet;
   nRet = MyMarker.SetHandle(&SomeMarkerHandle, FALSE);
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}