L_DicomSetLayerName

#include "l_bitmap.h"

L_LTDIC_API L_UINT16 L_DicomSetLayerName(hDS, pGraphicAnnSQItem, pszLayerName)

HDICOMDS hDS;	/* a DICOM handle */
pDICOMELEMENT pGraphicAnnSQItem;	/* pointer to a DICOMELEMENT structure */
L_TCHAR* pszLayerName;	/* new layer name */

Sets 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" (0070,0001) in the "Graphic Annotation Module".
pszLayerName	New layer name

Returns

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

Comments

This function sets 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

Platforms

Win32, x64

See Also

Functions:	L_DicomFindFirstGraphicAnnSQItem, L_DicomFindNextGraphicAnnSQItem, L_DicomGetLayerName, 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 DicomSetLayerNameExample(HDICOMDS hPresStateDS,L_TCHAR* pszLayerName)
{
   L_UINT16 nRet = L_DicomSetLayerName(hPresStateDS,
      L_DicomFindFirstGraphicAnnSQItem(hPresStateDS),
      pszLayerName);
   if(nRet == DICOM_SUCCESS)
   {
      MessageBox( NULL,
                  TEXT("Layer name has been updated successfully"),
                  TEXT("Note"),
                  MB_OK);
   }
   return nRet;
}