L_DicomGetLayerTextObjectCount

#include "l_bitmap.h"

L_LTDIC_API L_UINT16 L_DicomGetLayerTextObjectCount(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 object count */

Retrieves number of text annotation objects, which correspond to the specified item under the "Graphic Annotation Sequence" (0070,0001).

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 that will be updated with the Text object count, which correspond to the specified item.

Returns

0

SUCCESS

>0

An error occurred. Refer to Return Codes.

Comments

This function retrieves the number of text annotation objects, which correspond to the specified item under the "Graphic Annotation Sequence" (0008,1115) 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

Platforms

Win32, x64

See Also

Functions:

L_DicomGetLayerInfo, L_DicomSetLayerInfo, L_DicomRemoveLayerByIndex, L_DicomRemoveLayerByName, L_DicomRemoveAllLayers, L_DicomGetLayerCount, L_DicomGetLayerIndex, L_DicomGetLayerGraphicObjectCount, L_DicomRemoveLayerGraphicObjects, L_DicomRemoveLayerTextObjects, L_DicomGetLayerElementByIndex, L_DicomGetLayerElementByName

Topics:

Working with DICOM Annotations

 

Dicom Annotations: Layers

Example

L_INT DicomGetTextObjectsCountInAnnItemExample(HDICOMDS hPresStateDS)
{
   L_UINT16 nRet;
   L_TCHAR   szText[256] = TEXT("\0");
   L_UINT   uIndex;
   nRet = L_DicomGetLayerTextObjectCount(hPresStateDS,
                                          L_DicomFindFirstGraphicAnnSQItem(hPresStateDS), 
                                          &uIndex);
   if (nRet == DICOM_SUCCESS)
   {
      wsprintf(szText, TEXT("Number of Graphical Objects in the annotation sequence item is: %i"), uIndex);
      MessageBox( NULL, 
                  szText, 
                  TEXT("Note"), 
                  MB_OK);
   }
   return nRet;
}