Crop Method

Description

Crops the current image to the specified size.
Gets and sets the horizontal starting position, in pixels, of the view's crop rectangle.
Gets and sets the vertical starting position, in pixels, of the view's crop rectangle.

Syntax

Visual Basic
Public Sub Crop( _ ByVal IPCropX As Long, _ ByVal IPCropY As Long, _ ByVal IPCropWidth As Long, _ ByVal IPCropHeight As Long _ )

Parameters

IPCropX

The left component of the top-left coordinate of the rectangular area to crop.

Valid values are greater than or equal to zero.

IPCropY

The top component of the top-left coordinate of the rectangular area to crop.

Valid values are greater than or equal to zero.

IPCropWidth

The width of rectangular area to crop.

Valid values are greater than or equal to zero.

IPCropHeight

The height of rectangular area to crop.

Valid values are greater than or equal to zero.

Return Type

The horizontal (x-coordinate) starting position of the crop rectangle for the view.
The vertical (y-coordinate) starting position of the crop rectangle for the view.

Remarks

If the area defined by the crop parameters does not fall within the boundaries of the image, the image is not cropped and the ImagError property is set with IX_Error_InvalidCrop.

Note: This property is deprecated and the application should use the ViewCropX property.

The width and height of the crop rectangle is determined by the width and height of the control. The crop rectangle is a rectangular area within the boundaries of the control.

Note: This property is deprecated and the application should use the ViewCropY property.

The width and height of the crop rectangle is determined by the width and height of the control. The crop rectangle is a rectangular area within the boundaries of the control.