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

This function searches the Element List associated with the hIGMedElemList for the first Tag of the Group Number specified by GroupNum.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI MED_ElemList_move_find_first(
        HIGMEDELEMLIST hIGMedElemList, 
        AT_MODE level_op, 
        WORD GroupNum, 
        LPBOOL lpTagFound
);

Arguments:

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

A variable of type AT_MODE that tells the function how to move when it comes to an SQ. SQs are like indented outline items, allowing for hierarchies of Data Elements. Set this to one of the following constants:

  • MED_DCM_MOVE_LEVEL_FIXED: This setting tells the function to move only within the same level as the previous Current DE. An SQ and all its Data Elements are skipped over. If you are in a SQ, you can only move about the SQ.
  • MED_DCM_MOVE_LEVEL_FLOAT: This setting tells the function to move up or down as needed to get to the next DE. If the next DE is an SQ the Current DE moves down into it. At the end of the SQ, the Current DE will move back out to the lower levels (for example, from Level 2 to Level 1).
GroupNum WORD Set this WORD variable to the Group Number for which to search.
lpTagFound LPBOOL Returns TRUE is the Tag was found; FALSE otherwise.

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:

When the first Tag with group GroupNum is found, the Data Element is made the Current Data Element.

Which levels of the Element List will be considered depends on the setting of level_op.