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().