L_DicomGetTextObjectCount

#include "l_bitmap.h"

L_LTDIC_API L_UINT16 L_DicomGetTextObjectCount(hDS, pGraphicAnnSQItem, pCount)

HDICOMDS hDS;

/* a DICOM handle */

pDICOMELEMENT pGraphicAnnSQItem;

/* pointer to a DICOMELEMENT structure */

L_UINT* pCount;

/* pointer to a variable which will be updated with the text annotation object count */

Retrieves the number of text annotation objects in the specified "Graphic Annotation Sequence" (0070,0001) item.

Parameter

Description

hDS

A DICOM handle.

pGraphicAnnSQItem

Pointer to an item element under the "Graphic Annotation Sequence" (0008,1115) in the "Graphic Annotation Module".

pCount

Pointer to a variable, which will be updated with the text annotation object count.

Returns

0

SUCCESS

>0

An error occurred. Refer to Return Codes.

Comments

This function returns the number of text annotation objects in the specified "Graphic Annotation Sequence" (0070,0001) item in the "Graphic Annotation Module".

Required DLLs and Libraries

LTDIC

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:

L_DicomFindFirstGraphicAnnSQItem, L_DicomCreateGraphicAnnSQItem, L_DicomCreateTextObject, L_DicomRemoveTextObject, L_DicomGetTextObjectInfo, L_DicomSetTextObjectInfo, L_DicomRemoveAllTextObjects, L_DicomGetTextObjElement, L_DicomConvertLEADAnnObjToDicomAnnObjs, L_DicomConvertDicomAnnObjToLEADAnnObj

Topics:

Working with DICOM Annotations

 

Dicom Annotations: Text Objects

Example

L_INT DicomGetTextObjectCountExample(HDICOMDS hPresStateDS)
{
   L_UINT16 nRet;
   L_UINT uCount;

   pDICOMELEMENT pGraphicAnnSQItem = L_DicomFindFirstGraphicAnnSQItem(hPresStateDS);

   nRet = L_DicomGetTextObjectCount (hPresStateDS,pGraphicAnnSQItem, &uCount);
   if (nRet != DICOM_SUCCESS)
      return nRet;

   if (uCount >= 0)
   {
      L_TCHAR szText[256] = TEXT("\0");
      wsprintf(szText, TEXT("Number of Textual Annotations is:  %i"), uCount);
      MessageBox( NULL, 
                  szText, 
                  TEXT("Note"), 
                  MB_OK); 
   }
   return DICOM_SUCCESS;
}