ShowIPCropDlg Method

Description:

Shows the Image Processing: Crop dialog. The Image Processing: Crop dialog is as follows:

The Left/Top/Right/Bottom controls on the left side of the dialog are used to set the size of the cropping rectangle.

Note that there is no "undo" capability in this dialog: if the end-user clicks "OK" or "Apply", then the image referenced by thePageDisplay is modified. If your application needs to provide an "undo" capability, then you should make a copy of the IGPage Object associated with thePageDisplay before calling ShowIPCropDlg. Then, if the end-user decides to "undo" the action, your program can simply replace the modified IGPage Object with the unmodified copy.

The user can click the "Preview Changes" checkbox to see the cropping rectangle superimposed on the image in the preview area (they can leave the checkbox un-checked if the image is particularly large and therefore takes a long time to render).

Clicking the "OK" button will crop the image referenced by thePageDisplay, and then close the dialog. Note that you must specify the hWnd parameter in order for the end-user to see any changes to thePageDisplay image when they click "OK".

Clicking the "Apply" button will crop the image referenced by thePageDisplay, but leave the dialog on the screen - the preview will be redisplayed, showing the now-cropped image. Note that you must specify the hWnd parameter in order for the end-user to see any changes to thePageDisplay image when they click "Apply".

Clicking the "Cancel" button will close the dialog without making any changes.

Syntax:

      ShowIPCropDlg (thePageDisplay As IGPageDisplay, hWnd As Long)

Parameters:

Name	Description
thePageDisplay	Provide the IGPageDisplay Object that your program is using to handle display functions for your image.
hWnd	If your image is presented via IGPageViewCtl Control, then specify IGPageViewCtln.hWnd.

Return Value:

None

Bits Per Pixel:

N/A

Sample:

ig_guidlg.vb6.exe