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;
}