This method copies that portion of a raster image that is specified by the selected rectangle.

[C++Builder]   [ bool = ]imagekitcontrolname->Effect->CutRectImage()
[Delphi]   [ Boolean = ]imagekitcontrolname.Effect.CutRectImage()

Parameters

None

Return Value

Returns True if successful, otherwise returns False.

Explanation

The CutRectImage method allows you to copy a portion of a raster image without using a mask image. (If you wish to use a mask image, please refer to the SelectImage method). Although very similar to the SelectImage method, the CutRectImage method is much faster.

To execute the CutRectImage method, set the image handle of the image in the ImageHandle property or the Layer(LayerNo).ImageHandle property and specify the area to be copied by setting the RectLeft, RectTop, RectRight, and RectBottom properties. The CutRectImage method supports 1, 4, 8, 16, 24, and 32 bit images.

If successful the resulting raster image data is set in the LayerNo property (the ImageHandle property or the Layer(LayerNo).ImageHandle property. If unsuccessful, 0 is returned.

When the Caption, Message, and ButtonName properties are blank, the progress dialog box will not be displayed. When the progress dialog box is displayed, the percentage that the processing has completed will be shown in the dialog box.

 

The ImageKit10 VCL is a product created by Newtone Corporation