L_AnnGetArea

#include "l_bitmap.h"

L_LTANN_API L_INT L_AnnGetArea(hObject, puCount)

HANNOBJECT hObject;

/* handle to the annotation object */

L_SIZE_T *puCount;

/* address of a variable to be updated */

Gets the pixel count of the specified annotation object.

Parameter

Description

hObject

Handle to the annotation object from which to get the pixel count.

puCount

Address of the variable to be updated with the pixel count.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

The pixel count is the number of pixels contained in a region extracted from the annotation object, without resizing. It is equivalent to calling L_AnnGetRgnHandle with pRgnXForm set to NULL and then getting a pixel count of the resulting region.

Required DLLs and Libraries

LTANN

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:

L_AnnGetRgnHandle

Topics:

Annotation Functions: Object Information

 

Implementing Annotations

 

Automated User Interface for Annotations

 

Implementing an Automated Annotation Program

 

Obtaining Annotation Object Information

Example

L_INT EXT_CALLBACK AnnGetAreaAnnEnumCallback(HANNOBJECT   hObject,
                                             L_VOID*       pUserData);

 L_INT AnnGetAreaExample(HANNOBJECT hContainer)
{
   L_INT nRet;
   nRet = L_AnnEnumerate(hContainer, AnnGetAreaAnnEnumCallback, NULL, ANNFLAG_RECURSE|ANNFLAG_SELECTED, NULL);
   if(nRet != SUCCESS)
      return nRet;
   return SUCCESS;
}

L_INT EXT_CALLBACK AnnGetAreaAnnEnumCallback(HANNOBJECT   hObject,
                                             L_VOID*       pUserData)
{
   UNREFERENCED_PARAMETER(pUserData);
   L_INT    nRet;
   L_SIZE_T zCount;
   L_TCHAR  cs[80];

   nRet = L_AnnGetArea(hObject, &zCount);
   if (nRet == SUCCESS)
   {
      wsprintf(cs, TEXT("Pixel count = %ld\n"), zCount);
      MessageBox(NULL, cs, TEXT("Notice"), MB_OK);
   }
   else
   {
      wsprintf(cs, TEXT("Error #  %d\n"), nRet);
      MessageBox(NULL, cs, TEXT("Error"), MB_OK);
   }
   return SUCCESS;
}