LDicomDS::GetLayerElementByName

#include "Ltdic.h"

pDICOMELEMENT LDicomDS::GetLayerElementByName(pszLayerName)

L_TCHAR* pszLayerName;

/* graphic layer name */

Gets the item element of the specified graphic layer.

Parameter	Description
pszLayerName	Name of the graphic layer whose item element is to be retrieved.

Returns

!NULL	SUCCESS
NULL	An error occurred. Refer to Return Codes.

Comments

This function gets the item element under the "Graphic Layer Sequence" (0070,0060), which corresponds, to the layer with the specified name.

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:	LDicomDS::GetLayerInfo, LDicomDS::SetLayerInfo, LDicomDS::RemoveLayerByIndex, LDicomDS::RemoveLayerByName, LDicomDS::RemoveAllLayers, LDicomDS::GetLayerCount, LDicomDS::GetLayerIndex, LDicomDS::GetLayerGraphicObjectCount, LDicomDS::RemoveLayerGraphicObjects, LDicomDS::GetLayerTextObjectCount, LDicomDS::RemoveLayerTextObjects, LDicomDS::GetLayerElementByIndex, Class Members
Topics:	Working with DICOM Annotations
	How to Disable the Automatic Loading of the default DICOM IOD Table

Example

L_INT LDicomDS_GetLayerElementByNameExample(LDicomDS& PresStateDS, L_TCHAR* pszLayerName)  
{
   pDICOMELEMENT  pElement = PresStateDS.GetLayerElementByName(pszLayerName); 
   if (pElement) 
   {
      MessageBox( NULL, 
         TEXT("Element item for this layer has been found."), 
         TEXT("Note"), 
         MB_OK); 
   }
   return DICOM_SUCCESS;
}