LDicomContextGroup::InsertCodedConcept (original) (raw)
Summary
Adds a new Coded Concept to the specified Context Group.
Syntax
#include "ltdic.h"
static pDICOMCODEDCONCEPT LDicomContextGroup::InsertCodedConcept(pContextGroup, pszCodingSchemeDesignator, pszCodingSchemeVersion, pszCodeValue, pszCodeMeaning, pContextGroupLocalVersion = NULL, pszContextGroupExtensionCreatorUID = NULL, uFlags = 0)
Parameters
pDICOMCONTEXTGROUP pContextGroup
Pointer to a DICOMCONTEXTGROUP structure that specifies the Context Group to which the new Coded Concept is to be added.
L_TCHAR * pszCodingSchemeDesignator
Character string that contains the Coding Scheme Designator (0008,0102) for the new Coded Concept.
L_TCHAR * pszCodingSchemeVersion
Character string that contains the Coding Scheme Version (0008,0103) for the new Coded Concept. Set this to NULL if no Coding Scheme Version is to be defined for the new Coded Concept.
L_TCHAR * pszCodeValue
Character string that contains the Code Value (0008,0100) for the new Coded Concept.
L_TCHAR * pszCodeMeaning
Character string that contains the Code Meaning (0008,0104) for the new Coded Concept.
pVALUEDATETIME pContextGroupLocalVersion
Pointer to a VALUEDATETIME structure that specifies the Context Group Local Version (0008,0107) for the new Coded Concept. Set this to NULL if no Context Group Local Version is to be defined for the new Coded Concept.
L_TCHAR * pszContextGroupExtensionCreatorUID
Character string that contains the Context Group Extension Creator UID (0008,010D) for the new Coded Concept. Set this to NULL if no Context Group Extension Creator UID is to be defined for the new Coded Concept.
L_UINT16 uFlags
Flags that control the behavior of this function. This can be set to 0 or one of the following values:
| Value | Meaning |
|---|---|
| DICOM_CONTEXTGROUP_DISALLOW_DUPLICATES | [0x01] The function should fail if a Coded Concept with the same specified Coding Scheme Designator and Code Value already exists in the specified Context Group. |
Returns
| Value | Meaning |
|---|---|
| !NULL | Pointer to a DICOMCODEDCONCEPT structure that specifies the newly inserted Coded Concept. |
| NULL | The function failed to allocate memory. |
Comments
NOTE: If the Coding Scheme Designator, the Code Value, and the Code Meaning of the new Coded Concept are not specified, the function fails and Returns NULL.
If a Context Group in the Context Group Table has a corresponding Group in the internal table maintained by LEADTOOLS, then you can use the LDicomContextGroup::Default function to discard any changes made to the Context Group, including any additions of new Coded Concepts.
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
See Also
Functions
- LDicomContextGroup::SetCodeMeaning
- LDicomContextGroup::DeleteCodedConcept
- LDicomContextGroup::GetFirstCodedConcept
- LDicomContextGroup::FindIndexCodedConcept
- LDicomContextGroup::Default
- Class Members
Topics
- Working with Context Groups
- How to Disable the Automatic Loading of the default DICOM Context Group Table
Example
For an example, refer to LDicomContextGroup::Find.