L_DicomGetLayerImageRefCount

Show in webframe

#include "l_bitmap.h"

L_LTDIC_API L_UINT16 L_DicomGetLayerImageRefCount(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 referenced image count */

Retrieves number of referenced images, 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, which will be updated with the number of referenced images.

Returns

DICOM_SUCCESS	The function was successful.
>0	An error occurred. Refer to Return Codes.

Comments

This function retrieves the number of referenced images, 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, Linux.

See Also

Functions:	L_DicomAddLayerImageRef, L_DicomRemoveImageRefFromLayer, L_DicomRemoveAllImageRefsFromLayer, L_DicomRemoveAllImageRefFromAllLayers, L_DicomGetLayerImageRefElement
Topics:	Working with DICOM Annotations
	Dicom Annotations: Layers

Example

L_INT DicomGetReferencedImageCountExample(HDICOMDS hPresStateDS)
{
   pDICOMELEMENT pGraphicAnnSQItem = L_DicomFindFirstGraphicAnnSQItem(hPresStateDS);
   L_UINT uCount;
   L_UINT16 nRet = L_DicomGetLayerImageRefCount(  hPresStateDS , 
                                                   pGraphicAnnSQItem, 
                                                   & uCount);
   if (nRet != DICOM_SUCCESS)
      return nRet;
   if (uCount >= 0)
   {
      L_TCHAR szText[256] = TEXT("\0");
      wsprintf(szText, TEXT("Number of images is:  %i"), uCount);
      MessageBox( NULL, 
                  szText, 
                  TEXT("Note"), 
                  MB_OK);
   }
   return DICOM_SUCCESS;
}