Please enable JavaScript to view this site.

Raster Image Printer

Description

Sets the page margin cropping options in the IPNSession object. The concept of page cropping is analogous to scissors that cut away sections of paper. In this case the top, left, right and bottom edges of the page are removed and the remaining image area is smaller than the original page.

To set a single page margin 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, CropRight, CropBottom)

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

The desired width of the left margin to crop in pnUnits from the left-hand side of the page.

Double CropTop

The desired height of the top margin to crop in pnUnits from the top of the page.

Double CropRight

The desired width of the right margin to crop in pnUnits from the right-hand side of the page.

Double CropBottom

The desired height of the bottom margin to crop in pnUnits from the bottom of the page.

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

SectionName:

Processing

PropertyName:

Units

varValue:

VT_BSTR, one of the following:

.01 Inches

1 Millimeters

 

Ignored if the units are specified in the strings below

CropLeft

SectionName:

Processing

PropertyName:

Crop margin left

varValue:

VT_BSTR, one of the following ranges:

0-8000000 (hundredths of an inch)

0-20000000 (tenths of a millimeter)

0in-80000in (inches)

0cm-200000.000cm (centimeters)

CropTop

SectionName:

Processing

PropertyName:

Crop margin top

varValue:

VT_BSTR, one of the following ranges:

0-8000000 (hundredths of an inch)

0-20000000 (tenths of a millimeter)

0in-80000in (inches)

0cm-200000.000cm (centimeters)

CropRight

SectionName:

Processing

PropertyName:

Crop margin right

varValue:

VT_BSTR, one of the following ranges:

0-8000000 (hundredths of an inch)

0-20000000 (tenths of a millimeter)

0in-80000in (inches)

0cm-200000.000cm (centimeters)

CropBottom

SectionName:

Processing

PropertyName:

Crop margin bottom

varValue:

VT_BSTR, one of the following ranges:

0-8000000 (hundredths of an inch)

0-20000000 (tenths of a millimeter)

0in-80000in (inches)

0cm-200000.000cm (centimeters)

There is no parameter for this option, it is automatically set.

SectionName:

Processing

PropertyName:

Crop Option

varValue:

VT_I4, must be 1 to crop margins

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

See Also: SetPageBrightness SetPageCropOn SetPageCropAreaOptions SetPageRotationOptions SetPageTrimOptions SetProperty pnUnits