L_DicomGetFirstTag

#include "Ltdic.h"

L_LTDIC_API pDICOMTAG L_DicomGetFirstTag(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:

L_DicomGetLastTag

L_DicomGetPrevTag

L_DicomGetNextTag

To determine the number of entries in the Data Element Tag Table, use L_DicomGetCountTag.

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:

L_DicomGetLastTag, L_DicomGetPrevTag, L_DicomGetNextTag, L_DicomGetCountTag

Topics:

Working with Tags

Example

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

L_INT DicomGetFirstTagExample(HWND hDlg)
{
   pDICOMTAG pTag;

   pTag = L_DicomGetFirstTag();
   while (pTag != NULL)
   {
      SendMessage(hDlg, LB_ADDSTRING, (WPARAM)0, (LPARAM)(LPCTSTR)pTag->pszName);
      pTag = L_DicomGetNextTag(pTag);
   }

   return DICOM_SUCCESS;
}