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.