L_DicomGetLayerName

#include "l_bitmap.h"

* L_LTDIC_API L_TCHAR L_DicomGetLayerName(hDS, pGraphicAnnSQItem)

HDICOMDS hDS;

/* a DICOM handle */

pDICOMELEMENT pGraphicAnnSQItem;

/* pointer to a DICOMELEMENT structure */

Retrieves the value of the "Graphic Layer" element under one of the items under the "Graphic Annotation Sequence" in the "Graphic Annotation Module".

Parameter

Description

hDS

A DICOM handle.

pGraphicAnnSQItem

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

Returns

!NULL

A pointer to a string.

NULL

An error occurred.

Comments

This function retrieves the value of the "Graphic Layer" element under one of the items under the "Graphic Annotation Sequence" 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_DicomFindNextGraphicAnnSQItem, L_DicomSetLayerName, L_DicomCreateGraphicAnnSQItem, L_DicomAddLayerImageRef, L_DicomGetLayerImageRefCount, L_DicomRemoveImageRefFromLayer, L_DicomRemoveAllImageRefsFromLayer, L_DicomRemoveAllImageRefFromAllLayers,L_DicomGetLayerImageRefElement

Topics:

Working with DICOM Annotations

 

Dicom Annotations: Layers

Example

L_INT DicomGetLayerNameExample(HDICOMDS hPresStateDS)
{
   L_TCHAR szText[256] = TEXT("\0");
   L_TCHAR* pszLayerName = NULL;

   pszLayerName = L_DicomGetLayerName( hPresStateDS,
                                       L_DicomFindFirstGraphicAnnSQItem(hPresStateDS));
   if(pszLayerName)
   {
      wsprintf(szText, TEXT("Layer name in the annotation sequence item is: %s"), pszLayerName);
      MessageBox( NULL, 
                  szText, 
                  TEXT("Note"), 
                  MB_OK);
      return DICOM_SUCCESS;
   } 
   return DICOM_ERROR_NULL_PTR;
}