Please enable JavaScript to view this site.

TIFF Image Printer

Description

Sets the hardware margin options on the IPNSession object.

The hardware margins option allows you to customize the size of the printer-supplied edge on your outputted files. Hardware margins cannot be larger than 1.00in (2.54cm) on each side of the paper. You can enter units with up to three digits of accuracy, or to an eighth of an inch (0.125in or 0.318cm).

To clear a single hardware margin option use the SetProperty call with the appropriate arguments. See the Remarks below for a list of arguments.

For a more detailed explanation of hardware margins, see the Printer Overrides options in the conversion profile settings.

Syntax

expression.SetHardwareMargins(Units, HardwareMarginLeftRight, HardwareMarginTopBottom)

where expression is an IPNSession object.

Parameters

pnUnits Units

A pnUnits constant for the unit of measure used to enter any paper size options.

Double HardwareMarginLeftRight

The left and right hardwarre margin settings in units to match Units.

Double HardwareMarginTopBottom

The top and bottom hardware margin settings in units to match Units.

Remarks

Use the following to set these options using SetProperty:

Method Parameter

SetProperty Parameters

Units

SectionName:

Advanced Features

PropertyName:

Units

varValue:

VT_BSTR, one of the following:

.01 Inches

1 Millimeters

 

Ignored if the units are specified in the strings below

HardwareMarginLeftRight

SectionName:

Advanced Features

PropertyName:

Hardware Margin Left

varValue:

VT_BSTR, one of the following ranges:

0-100 (hundredths of an inch)

0-254 (tenths of a millimeter)

0.0in-1.0in (inches)

0.0cm-2.540cm (centimeters)

HardwareMarginTopBottom

SectionName:

Advanced Features

PropertyName:

Hardware Margin Top

varValue:

VT_BSTR, one of the following ranges:

0-100 (hundredths of an inch)

0-254 (tenths of a millimeter)

0.0in-1.0in (inches)

0.0cm-2.540cm (centimeters)

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

See Also: SetCustomPaperOn SetCustomPaperOptions SetProperty pnUnits