LDicomTag::GetFirst

#include "Ltdic.h"

static pDICOMTAG LDicomTag::GetFirst(L_VOID)

Returns a pointer to the first item in the Data Element Tag Table.

Returns

!NULL

A pointer to a DICOMTAG structure that contains the first item in the Data Element Tag Table.

NULL

The table is empty.

Comments

The following functions will also help you navigate the Data Element Tag Table:

LDicomTag::GetLast

LDicomTag::GetPrev

LDicomTag::GetNext

To determine the number of entries in the Data Element Tag Table, use LDicomTag::GetCount.

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:

LDicomTag::GetLast, LDicomTag::GetPrev, LDicomTag::GetNext, LDicomTag::GetCount

Topics:

Working with Tags

Example

This example displays in a list-box control all items from the Tag table.

L_INT LDicomTag_GetFirstExample(CListBox *pDlg)
{
   UNREFERENCED_PARAMETER(pDlg);
   pDICOMTAG pTag;
   pTag = LDicomTag::GetFirst();
   while (pTag != NULL)
   {
      ::MessageBox(NULL, pTag->pszName, TEXT("Tag Name"), MB_OK);
      pTag = LDicomTag::GetNext(pTag);
   }
   return DICOM_SUCCESS;
}