LDicomDS::DeleteKey

Summary

Deletes the specified key element from the Dicom Dir Data Set.

Syntax

#include "ltdic.h"

L_VOID LDicomDS::DeleteKey(pElement)

Parameters

pDICOMELEMENT pElement

Pointer to a DICOMELEMENT structure that contains the key element to delete.

Returns

None.

Comments

When a key element is deleted using this function, all offspring of the key element (both key element children and non-key element children) and all their respective children are also deleted.

Below are illustrations of this:

For the sake of these illustrations, the order of siblings is top to bottom.

NOTE: The numbering of the items of interest is arbitrary, and does not imply order.

In this illustration item 2 will be deleted. If any of the children of item 2 had children, these would be deleted also.

image\IODDlAft.gif

In this illustration item 3 will be deleted. Again, if any of the children of item 2 had children, these would be deleted also.

image\IODDlBef.gif

NOTE: Key elements should not be deleted using LDicomDS::DeleteElement. Deleting a key element using LDicomDS::DeleteElement will not delete any child key elements, but will delete information that references the child key elements.

For more information about key elements, refer to Working with Basic Directory Key Elements.

Required DLLs and Libraries

Platforms

Win32, x64

See Also

Functions

Topics

Example

For an example, refer to LDicomDS::InsertKey.

Help Version 22.0.2022.12.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS DICOM C++ Class Library Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.