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

This function moves the Current Data Element to the Data Element in the Element List indicated by index, which represents a particular index in the array of Data Elements that makes up the Element List.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI MED_ElemList_move_index(
        HIGMEDELEMLIST hIGMedElemList, 
        DWORD index
);

Arguments:

Name Type Description
hIGMedElemList HIGMEDELEMLIST HIGMEDELEMLIST handle to the Data Element List object.
index DWORD Set to a DWORD that indicates the index that you would like to become the new Current Data Element.

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:

This function also returns the Tag's VR (Value Representation), its Tag value, the number of bytes in the Tag's data, and the Item Count. The index refers to which element in the Data Element array should be used. The first Data Element will always have an index of 0, and the last Data Element will always have an index of (Total number of DEs - 1). Use MED_ElemList_curr_info_get()to find out the total number of Data Elements associated with an image's Element List.

This function pays no attention to Levels. It only returns you the level of the Current Data Element.