InsertBitmapListValue method

Builder Syntax	int __fastcall InsertBitmapListValue(Ltvcltyp::HBITMAPLIST BitmapList, Cardinal uIndex, int nCompression, int nPhotometric, int nBitsPerPixel, int nQFactor);
Delphi Syntax	function InsertBitmapListValue(BitmapList: HBITMAPLIST; uIndex: Cardinal; nCompression, nPhotometric, nBitsPerPixel, nQFactor: Integer): Integer;
Overview	Refer to Working with Data Sets.

Remarks

This method inserts the images in the given Bitmap List into the Pixel Data Element.

As an example, if you wish to insert 50 images starting with the 50th frame in the Pixel Data, call this function with uIndex set to 49 (the 50th frame in a zero-based index) and the 50 frames you wish to insert in BitmapList.

Most DICOM files will only have one Data Element of type TAG_PIXEL_DATA. Therefore, in most instances the CurrentElement property can be Nil (NULL), since the method will automatically replace the images of the only Pixel Data Element in the file. If the CurrentElement property is not Nil, it must contain the Pixel Data Element itself.

If the DICOM file is CLASS_BASIC_DIRECTORY, the file may contain more than one Pixel Data Element. In this case you must specify in the CurrentElement property the Pixel Data Element in which the images will be replaced.

If you wish to replace only one image within the Pixel Data Element, you must use DeleteBitmapValue method and InsertBitmapValue method.