LDicomContextGroup::GetFirstCodedConcept

#include "ltdic.h"

static pDICOMCODEDCONCEPT LDicomContextGroup::GetFirstCodedConcept(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

Functions:	LDicomContextGroup::Load, LDicomContextGroup::Insert, LDicomContextGroup::GetLastCodedConcept, LDicomContextGroup::GetNextCodedConcept, LDicomContextGroup::GetPrevCodedConcept, LDicomContextGroup::GetCountCodedConcept, LDicomContextGroup::FindIndexCodedConcept, LDicomContextGroup::GetContextGroup, LDicomContextGroup::SetCodeMeaning, LDicomContextGroup::DeleteCodedConcept, LDicomContextGroup::GetFirst, Class Members
Topics:	Working with Context Groups
	How to Disable the Automatic Loading of the default DICOM Context Group Table

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
}