InsertDicomFile method (ILEADDicomDir Interface)

Remarks

Adds the specified DICOM file to the Dicom Directory referenced by this interface.

Before using this method, a destination folder must have been specified using the ResetDicomDir method. Otherwise, this method will fail.

The DICOM file to be added must reside in the destination folder or in a subfolder of the destination folder. Otherwise, the method will fail and the file will not be added to the Directory. For example, if the destination folder is specified as "C:\DICOM Images\", then the DICOM file "C:\DICOM Images\Patient 1\Brain" can be added to the Directory, while the DICOM file "C:\Images\Knee" cannot be added. Please notice that the filename passed to the method must specify the absolute path of the file, not the relative one.

If the parameter bstrFileName is set to NULL, the method will add all the DICOM files contained in the destination folder to the Dicom Directory. In this case, the DicomFileInsert event will be fired for each file, so that the progress can be monitored. To add the DICOM files in the subfolders of the destination folder, set the IncludeSubfolders property to VARIANT_TRUE. Therefore, to add all the Dicom files in the destination folder and all the Dicom files in the subfolders of the destination folder, set the IncludeSubfolders property to VARIANT_TRUE and then call the InsertDicomFile method with bstrFileName set to NULL.

See Also