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.