LDicomContextGroup::GetFirstCodedConcept
#include "ltdic.h"
static pDICOMCODEDCONCEPT LDicomContextGroup::GetFirstCodedConcept(pContextGroup)
pDICOMCONTEXTGROUP pContextGroup; |
/* pointer to a Context Group */ |
Returns a pointer to the first Coded Concept in the specified Context Group.
Parameter |
Description |
pContextGroup |
Pointer to a DICOMCONTEXTGROUP structure that specifies a Context Group in the Context Group Table. The function Returns a pointer to the first Coded Concept in this Group, if it contains any. |
Returns
!NULL |
Pointer to a DICOMCODEDCONCEPT structure that specifies the first Coded Concept in the specified Context Group. |
NULL |
The specified Context Group does not contain any Coded Concepts. |
Comments
Along with this function, the following functions can be used to maneuver through the Coded Concepts of a Context Group in the Context Group Table:
LDicomContextGroup::GetLastCodedConcept
LDicomContextGroup::GetNextCodedConcept
LDicomContextGroup::GetPrevCodedConcept
You can also use the LDicomContextGroup::GetCountCodedConcept and LDicomContextGroup::FindIndexCodedConcept functions to enumerate the Coded Concepts.
Use the LDicomContextGroup::GetContextGroup function to obtain the Context Group to which a Coded Concept belongs.
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 |
See Also
Example
L_VOID EnumCodedConcepts(pDICOMCONTEXTGROUP pGroup) { // Is it a valid pointer? if (!LDicomContextGroup::Exists(pGroup)) { return; } pDICOMCODEDCONCEPT pConcept; // Enumerate the Coded Concepts in the Context Group (3 possible ways) #if 1 // One possible way to enumerate the Coded Concepts pConcept = LDicomContextGroup::GetFirstCodedConcept(pGroup); while (pConcept) { // Refer to the example of LDicomContextGroup::GetContextGroup for // the function GetContextGroupExample if(!DisplayCodedConcept(pConcept, TRUE)) { break; } pConcept = LDicomContextGroup::GetNextCodedConcept(pConcept); } #elif 0 // Another way to enumerate the Coded Concepts L_UINT32 uConceptsCount; uConceptsCount = LDicomContextGroup::GetCountCodedConcept(pGroup); for (L_UINT32 i = 0; i < uConceptsCount; i++) { pConcept = LDicomContextGroup::FindIndexCodedConcept (pGroup, i); if(!DisplayCodedConcept(pConcept, TRUE)) { break; } } #elif 0 // A third way to enumerate the Coded Concepts pConcept = LDicomContextGroup::GetLastCodedConcept(pGroup); while (pConcept) { if(!DisplayCodedConcept(pConcept, TRUE)) { break; } pConcept = LDicomContextGroup::GetPrevCodedConcept(pConcept); } #endif }