RefBitmap property (Main Control)

Visual Basic example
Visual C++ 4.0 example
Visual J++ example

Syntax BOOL RefBitmap

Overview: Refer to Bitmaps and Bitmap Lists.

Remarks

Indicates whether an assignment to the Bitmap property should do a copy or simply reference the source control's Bitmap property.

This is used mainly to communicate between the Main control and a Common Dialog. When this property is TRUE, any assignments to the Main Control's Bitmap property will cause the Main Control to reference the source control's Bitmap, instead of making a copy. This can be used to reduce memory load when dealing with large images.

When this property is FALSE, an assignment to the Main Control's Bitmap proprety will create a copy of the source control's Bitmap in memory.

Note: When this property is set to True, any assignment to the Main Control's Bitmap property will invalidate the bitmap in the source control.

You should set this property back to False after making an assignment if you do not always wish to make references. For example:

LEAD1.RefBitmap = True
LEAD1.Bitmap = LEADDlg1.Bitmap
LEAD1.RefBitmap = False