RefBitmapList property (ILEADRaster)

Remarks

Indicates whether an assignment to the BitmapList property should do a copy or simply move the source object's BitmapList to the destination object's BitmapList. Possible values are:

This property is taken into account when setting the BitmapList property of the object. If RefBitmapList is true, then the destination object will ‘steal’ the bitmaps from the source object. The source object will eventually detect that its bitmap list is empty, but you should notify the source object that its list has been freed by setting its bitmap list to NULL. If RefBitmapList is False, then the destination object makes a copy of the source object’s bitmap list. That means that two copies of the list exist in memory. Many times, we are trying to move the list from one object to the other with code like this:

LEAD1.BitmapList = LEAD2.BitmapList
LEAD2.BitmapList = 0

In this case, it is much faster to set RefBitmapList to TRUE before assigning the bitmap list. By doing that, you don’t have two copies of the bitmap list.

See Also