IKCutRectImage

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

[C++Builder/Visual C++] HANDLE IKCutRectImage(HANDLE Handle, LPRECT Rect, IKPROCESSPROC UserProc, LPCTSTR Caption, LPCTSTR Message, LPCTSTR Button);

[Delphi] function IKCutRectImage(Handle: THandle; var Rect: TRect; UserProc: LONG_PTR; Caption, Message, Button: PChar): THandle;

[Visual Basic] Function IKCutRectImage(ByVal Handle As Long, Rect As IKRECT, ByVal UserProc As Long, ByVal Caption As String, ByVal Message As String, ByVal Button As String) As Long

Parameters

Name	Explanation
Handle	The image handle of the raster image (1, 4, 8, 16, 24, or 32 bit image)
Rect	A structure specifying the coordinates for the rectangle bounding the area on the image
UserProc	The address of the user function (If not using the user function then set to 0)
Caption	Sets the text displayed in the title bar of the progress dialog box
Message	Sets the message displayed in the progress dialog box
Button	Sets the name of the button displayed in the progress dialog box

Return Value

Returns the raster image handle if successful. Returns 0 if unsuccessful.

Explanation

The IKCutRectImage function copies that portion of a raster image that is specified by the selected rectangle. (If you wish to use a mask image, please refer to the IKSelectImage(EX) function). Although very similar to the IKSelectImage(EX) function, the IKCutRectImage function is much faster.

Note: The image handle passed to the Handle parameter is not automatically freed after execution.

If the user function is set or if the Caption, Message, and Button parameters are blank then the Progress dialog box is not displayed. If the Progress dialog box is displayed, it indicates the percentage of the current process completed. For more information about the user function please refer to the Definition of User Function in the Ik9Effect.dll, Ik9EffectA.dll, Ik9Effect64.dll, Ik9Effect64A.dlll section.