ImageGear for C and C++ on Windows v19.4 - Updated
MED_ElemList_info_get
API Reference Guide > MD Component API Reference > MD Component Functions Reference > Data Set Element List Functions > MED_ElemList_info_get

This function returns the number of Data Elements (DEs) associated with the Element List hIGMedElemList.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI MED_ElemList_info_get(
        HIGMEDELEMLIST hIGMedElemList, 
        LPDWORD lpNumTags, 
        LPDWORD lpMaxLevel
);

Arguments:

Name Type Description
hIGMedElemList HIGMEDELEMLIST HIGMEDELEMLIST handle to the Data Element List object.
lpNumTags LPDWORD A far pointer to a DWORD which returns the number of Data Elements (same as the number of Tags) associated with the image's Element List.
lpMaxLevel LPDWORD A far pointer to a DWORD which returns the maximum SQ Level of the Element List.

Return Value:

Returns the number of ImageGear errors that occurred during the function call.

Supported Raster Image Formats:

This function does not process image pixels.

Remarks:

You might use the number of DEs returned to set the limit on a loop that iterates through each Data Element in a Element List. If the DataSet contains SQ (Sequence of Items) data elements, the method returns the total number of data elements, including data elements contained within sequences. If there are no SQ Data Elements, lpMaxLevel is set to 0.