GetFloaterHandle method (Main Control)

C++ 4.0 example

Delphi example

 

Builder Syntax

L_HRGN GetFloaterHandle(void)

Delphi Syntax

GetFloaterHandle: L_HRGN

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.

See Also

Elements:

GetRgnHandle method, DeleteRgnHandle method, FreeRgn method, SetRgnHandle method

Topics:

Raster Images: Creating and Using a Region