Floater property (Main Control)

C++ Builder example

Delphi example

 

Builder Syntax

LEADTyp::TBitmapHandle Floater

Delphi Syntax

Floater: TBitmapHandle

Overview

Refer to Creating and Using a Bitmap Region.

Remarks

Specifies the floater bitmap for the Main Control.

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.

The behavior of this property depends on the AutoFloater property as follows:

image\sqrblit.gif If AutoFloater is True, you can use the EnableFloater property to enable automatic creation of a floater using the mouse. In this case, this property is automatically assigned a value depending on the user mouse actions.

image\sqrblit.gif If AutoFloater is False, you can create the floater bitmap by assigning the Main Control's Bitmap property to it. The floater bitmap that this creates is the size of the bounding rectangle of the main bitmap's region, and it contains the same region as the main bitmap.

You can also make a copy of the floater bitmap by assigning it to the another Main Control's Bitmap property.

Note:

If AUTOPROCESS is set in the UIFlags property for any Dialog, and the image has a floater, this floater will be pasted and the region will be freed, if the user clicks OK in the Dialog.

See Also

Elements:

FloaterVisible property, IsPtInFloater method, EnableFloater property, AutoFloater property

Topics:

Raster Images: Copying Images

 

Raster Images: Creating and Using a Region