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

This function gets the data item from the Current Data Element, and always returns it to you as a NULL-terminated character string.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI MED_ElemList_curr_data_item_get_string(
        HIGMEDELEMLIST hIGMedElemList,
        INT item_index,
        LPCHAR lpString, 
        DWORD size_of_lpString
);

Arguments:

Name Type Description
hIGMedElemList HIGMEDELEMLIST HIGMEDELEMLIST handle to the Data Element List object.
item_index INT Index of Data Item in Data Element.
lpString LPCHAR A far pointer to a CHARbuffer into which the data will be copied.
size_of_lpString DWORD Size of above buffer, lpString.

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:

The marker to the Current Data Element can be moved using one of the MED_DCM_DS_move_...() functions.

Data Elements can be of many different data types (int, word, bytes, float, double, string, etc.), but this function will always convert the data to a string. To return the data in its "natural form", use MED_DCM_DS_curr_data_get().