#include "ltdic.h"
L_UINT16 LDicomDS::AnnDelete (nIndex, nPage)
Deletes a page from an annotation file, deletes the entire annotation file, or deletes all annotation files stored in a DICOM data set. This function is available in the Medical Imaging Toolkits.
Index into an array of annotation files stored in the DICOM data set. Each DICOM data set can store up to 256 annotation files. This is a zero-based index. Valid values are between 0 and 255. Pass 1 to delete ALL annotation files and the private creator data element.
Number of the page to delete. The page number is 1-based. Therefore, the first page is page 1, the second page is page 2, etc. Pass 1 to delete the entire file specified by the nIndex parameter.
Value | Meaning |
---|---|
0 | SUCCESS. |
> 0 | An error occurred. Refer to Return Codes. |
LEAD Annotation files can be saved as private data in a DICOM data set (LEAD native format or binary encoded format). There can be up to 256 private data tags for LEAD annotation files. [LDicomDS:AnnDelete can delete a page from an annotation file, delete the entire annotation file, or delete all annotation files in a DICOM data set.
To delete the third page of the annotation file at index 1:
LDicomDS DicomDS;
DicomDS.LoadDS("d:\work\images\a.dic", 0);
DicomDS.AnnDelete(1, 3);
To delete the annotation file at index 1:
LDicomDS DicomDS;
DicomDS.LoadDS ("d:\work\images\a.dic", 0);
DicomDS.AnnDelete(1, -1);
To delete all annotation files and the private creator data element:
LDicomDS DicomDS;
DicomDS.LoadDS ("d:\work\images\a.dic", 0);
DicomDS.AnnDelete(-1, 0);
NOTE: Both DICOM and DOCUMENT capabilities must be unlocked in order to work with DICOM annotations. For more information on unlocking these capabilities, refer to LSettings::SetLicenseFile.
Required DLLs and Libraries
Win32, x64
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document