In This Topic ▼

L_DicomConvertDicomAnnObjToLEADAnnObj

Summary

Converts a DICOM graphic or text annotation object into a LEAD annotation object.

Syntax

#include "ltdic.h"

L_LTDIC_API L_UINT16 L_DicomConvertDicomAnnObjToLEADAnnObj(hDS, phAnnObject, pGraphicObject, pTextObject)

Parameters

HDICOMDS hDS

A DICOM handle.

pHANNOBJECT phAnnObject

Address of the variable to be updated with the handle to the LEAD annotation object.

pDICOMGRAPHICOBJECT pGraphicObject

Pointer to a DICOMGRAPHICOBJECT structure, which holds the attributes of a DICOM graphic annotation object to be converted. Pass NULL if you are converting a DICOM text annotation object.

pDICOMTEXTOBJECT pTextObject

Pointer to a DICOMTEXTOBJECT structure, which holds the attributes of a DICOM text annotation object to be converted. Pass NULL if you are converting a DICOM graphic annotation object.

Returns

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

Comments

This function will convert a DICOM Annotation object into a LEAD annotation object.

If you are converting a DICOM graphic object, pGraphicObject should be valid and pTextObject should be set to NULL.

If you are converting a DICOM text object, pTextObject should be valid and pGraphicObject should be set to NULL.

pGraphicObject and pTextObject cannot both be valid or both be NULL at the same time.

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, Linux.

Example

L_INT DicomConvertDicomAnnObjToLEADAnnObjExample( 
   HDICOMDS hPresStateDS, 
   pDICOMGRAPHICOBJECT pGraphicObject, 
   pHANNOBJECT phAnnObject) 
{ 
 L_UINT16 nRet = L_DicomConvertDicomAnnObjToLEADAnnObj(hPresStateDS, 
                                                       phAnnObject, 
                                                       pGraphicObject, 
                                                       NULL); 
   if (nRet == DICOM_SUCCESS) 
   { 
      MessageBox(NULL, 
                 TEXT("DICOM annotation object  has been successfully converted into LEAD object."), 
                 TEXT("Note"), 
                 MB_OK); 
   } 
   return nRet; 
}