L_DicomGetLayerElementByIndex

#include "l_bitmap.h"

L_LTDIC_API pDICOMELEMENT L_DicomGetLayerElementByIndex(hDS, uLayerIndex)

HDICOMDS hDS;

/* a DICOM handle */

L_UINT uLayerIndex;

/* Zero-based index of the graphic layer */

Gets the item element of the specified graphic layer.

Parameter

Description

hDS

A DICOM handle.

uLayerIndex

Zero-based index of the graphic layer whose item element is to be retrieved.

Returns

!NULL

The function was successful.

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 at the specified index.

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_DicomGetLayerTextObjectCount, L_DicomRemoveLayerTextObjects, L_DicomGetLayerElementByName

Topics:

Working with DICOM Annotations

 

Dicom Annotations: Layers

Example

L_INT DicomGetLayerElementByIndexExample(
   HDICOMDS hPresStateDS,
   L_UINT uLayerIndex)
{
   pDICOMELEMENT pElement = L_DicomGetLayerElementByIndex(hPresStateDS, uLayerIndex);
   if (pElement)
   {
      MessageBox( NULL,
                  TEXT("Element item for this layer has been found."),
                  TEXT("Note"),
                  MB_OK);
      return DICOM_SUCCESS;
   }
   return DICOM_ERROR_NULL_PTR;
}