TIFF Image Printer

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:

Supported Printers: TIFF Image Printer, PDF Image Printer, Raster Image Printer

See Also: SetPageBrightness SetPageCropOn SetPageCropMarginOptions SetPageRotationOptions SetPageTrimOptions SetProperty pnUnits