Description
Sets any page area cropping options in the IPNSession object. The concept of page cropping is analogous to scissors that cut away sections of paper. In this case portions of the page are removed and the remaining image area is smaller than the original page.
If all four fields, CropLeft, CropTop, CropWidth and CropHeight, are 0 then no cropping is performed.
To set a only a single page area cropping option use the SetProperty call with the appropriate arguments. See the Remarks below for a list of arguments.
See the Crop Margins or Areas section for a more detailed explanation.
Syntax
expression.SetPageCropAreaOptions(Units, CropLeft, CropTop, CropWidth, CropHeight)
where expression is an IPNSession object.
Parameters
pnUnits Units
A pnUnits constant for the unit of measure used to enter the cropping measurements.
Double CropLeft
This is the leftmost starting point for the cropped area, in pnUnits from the left side of the page.
Double CropTop
This is the topmost starting point for the cropped area, in pnUnits from the top of the page.
Double CropWidth
The width of the area you want to crop from the original page in pnUnits. This area starts at CropLeft.
Double CropHeight
The width of the area you want to crop from the original page in pnUnits. This area starts at CropTop.
Remarks
Only one of SetPageCropAreaOptions or SetPageCropMarginOptions can be set at any one time. Whichever method is last called determines whether margins or a page area is cropped.
Use the following to set these options using SetProperty:
Method Parameter |
SetProperty Parameters |
||||||
---|---|---|---|---|---|---|---|
Units |
|
||||||
CropLeft |
|
||||||
CropTop |
|
||||||
CropWidth |
|
||||||
CropHeight |
|
||||||
There is no parameter for this option, it is automatically set. |
|
Supported Printers: TIFF Image Printer, PDF Image Printer, Raster Image Printer
See Also: SetPageBrightness SetPageCropOn SetPageCropMarginOptions SetPageRotationOptions SetPageTrimOptions SetProperty pnUnits