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

This function moves the Current Data Element up one level.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI MED_ElemList_move_ascend(
        HIGMEDELEMLIST hIGMedElemList
);

Arguments:

Name Type Description
hIGMedElemList HIGMEDELEMLIST HIGMEDELEMLIST handle to the Data Element List object

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 is only applicable if the Current Data Element is positioned within an SQ Data Element or within an Item Data Element.

If the Current Data Element is positioned anywhere in an SQ, the Current Data Element ascends to the SQ. If within an Item, the new Current DE becomes the Item DE. Only one level is ascended per call.

If the Current DE is at the top level (0), no action is taken.

Data Elements (as well as SQs and Item Delimiters) are always stored in even-numbered levels; odd-numbered levels contain Items and SQ Delimiters.