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.

Platforms

Win32, x64.

See Also

Functions:

LMarker::Copy, LMarker::Create, LMarker::Delete, LMarker::DeleteIndex, LMarker::Enum, LMarker::EnumMarkersCallBack, LMarker::Free, LMarker::GetCount, LMarker::GetHandle, LMarker::GetGlobalMarkers, LMarker::GetMarker, 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 MyMarker1; 
   LMarker MyMarker2; 
 
   nRet = MyMarker1.Load(MAKE_IMAGE_PATH(TEXT("ImageProcessingDemo\\Image1.jpg")), 0); 
   if(nRet != SUCCESS) 
      return nRet; 
 
   HANDLE SomeMarkerHandle = MyMarker1.GetHandle(); 
 
   nRet = MyMarker2.SetHandle(&SomeMarkerHandle, FALSE); 
   if(nRet != SUCCESS) 
      return nRet; 
 
   nRet = MyMarker2.SetHandle(NULL, FALSE); 
   if(nRet != SUCCESS) 
      return nRet; 
 
   return SUCCESS; 
 
} 
Help Version 20.0.2020.4.5
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C++ Class Library Help