Parameters
NoneReturn Value
Returns True (nonzero) if successful, otherwise returns False (0).
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 or the SelectImageVariant methods).
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.