ImageGear Professional DLL for Windows
MED_ElemList_curr_data_item_set
| ImageGear Professional v18.2 > API Reference Guide > MD Component API Reference > MD Component Functions Reference > Data Set Element List Functions > MED_ElemList_curr_data_item_set |
This function sets the data item of the current multi valued Data Element.
|
Copy Code
|
|
|---|---|
AT_ERRCOUNT ACCUAPI MED_ElemList_curr_data_item_set(
HIGMEDELEMLIST hIGMedElemList,
INT item_index,
LPVOID lpData,
DWORD size_of_data
);
|
|
| Name | Type | Description |
| hIGMedElemList | HIGMEDELEMLIST | HIGMEDELEMLIST handle to the Data Element List object. |
| item_index | INT | Index of Data Item in Data Element. |
| lpData | LPVOID | A far pointer to a VOID buffer into which the data will be copied. |
| size_of_lpData | DWORD | Size of above buffer, lpData. |
Returns the number of ImageGear errors that occurred during the function call.
This function does not process image pixels.
Each Data Element can be of one of many different data types (int, word, bytes, float, double, string, etc.) You must know the VR (Value Representation) of the data in order to use this data.
This function allows you to overwrite the data item of the current multi valued Data Element, by copying the data from your buffer to the HDS table. The Data must be of the correct data type to match the Value Representation (VR) of the Current DE. You can use MED_ElemList_curr_data_item_get()to find out the VR of the Current DE.
The length of a DICOM Data Field must always be an even number. If you set the size_of_lpData to an odd number of bytes, ImageGear will pad it (and your data) to make it an even-numbered length.
An error is set if the data type does not match the VR of the Current DE.