L_DicomCreateGraphicAnnSQItem
#include "l_bitmap.h"
L_UINT16 EXT_FUNCTION L_DicomCreateGraphicAnnSQItem(hDS, nIndex, pszLayerName)
HDICOMDS hDS; |
/* a DICOM handle */ |
L_UINT32 nIndex; |
/* index value */ |
L_CHAR* pszLayerName; |
/* layer name */ |
Adds a new item under the "Graphic Annotation Sequence".
Parameter |
Description |
hDS |
A DICOM handle. |
nIndex |
Index value that indicates where to insert a TAG_ITEM data element in a sequence. The index is zero based, so if you want to insert a TAG_ITEM data element as the first item in the sequence, set this to 0. The value ELEMENT_INDEX_MAX indicates to add the TAG_ITEM data element to the end of the sequence. |
pszLayerName |
Value of the attribute "Graphic Layer " (0070, 00202), under the newly created item. |
Returns
0 |
SUCCESS |
>0 |
An error occurred. Refer to Return Codes. |
Comments
This function will add a new item under the "Graphic Annotation Sequence" (0070,0001) in the "Graphic Annotation Module". If the sequence doesn�t already exist, then this function will create it first and then add the new item.
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
Example
L_VOID CreateAnnSequenceItem(HDICOMDS hPresStateDS)
{
L_UINT16 nRet = L_DicomCreateGraphicAnnSQItem ( hPresStateDS,
0,
"New Layer");
if (nRet == DICOM_SUCCESS)
{
MessageBox( NULL,
"The Item has been created successfully.",
"Note",
MB_OK);
}
}