GetFloaterHandle method (Main Control)

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

Syntax OLE_HANDLE GetFloaterHandle ();

Overview: Refer to Creating and Using a Bitmap Region.

Remarks

Stores a copy of the floater bitmap's region and returns a Windows region handle that you can use to retrieve or delete the stored region.

Keep in mind that the region data contains only positioning information relative to the floater bitmap, not the bitmap's pixel values.

To retrieve the stored region and add it to the bitmap, use the SetRgnHandle method. To delete the stored region, use the DeleteRgnHandle method.

A floater is an additional bitmap that is associated with the Main Control. Its common application is to implement the interactive visual aspects of an outline-drag-and-paste operation. You use it to get a copy of the image in the current bitmap region, which the user can drag to another position in the Main Control's client area.