Please enable JavaScript to view this site.

TIFF Image Printer

Description

Sets fax options on the IPNSession object.

To set a single fax option use the SetProperty call with the appropriate arguments. See the Remarks below for a list of arguments.

Syntax

expression.SetFaxOptions(FaxProfile, FaxResolution, FaxPaperWidth, FaxPaperHeight,

                         FaxPageScaling, FaxPageHAlign, FaxPageVAlign,

                         FaxPageShrinkIfLarger, FaxPageAutoRotate,FaxPageMaintainAspect)

where expression is an IPNSession object.

Parameters

pnFaxProfile FaxPofile

A pnFaxProfile constant for the fax format profile to to use.

pnFaxResolution FaxResolution

A pnFaxResolution constant for the fax resolution to create. The fax format profile being used determines what resolutions are valid. Not all resolutions are valid with all fax format profiles.

pnFaxPaperWidth FaxPaperWidth

A pnFaxPaperWidth constant for the width of the fax paper to be used when creating the faxable image.

pnFaxPaperHeight FaxPaperHeight

A pnFaxPaperHeight constant to set the height of the fax paper.

pnFaxPageScaling FaxPageScaling

A pnFaxPageScaling constant to determine how the page is scaled to the size of the fax paper.

pnFaxPageScalingHAlign FaxPageHAlign

A pnFaxPageScalingHAlign constant to determine how to horizontally align the page on the fax paper.

pnFaxPageScalingVAlign FaxPageVAlign

A pnFaxPageScalingVAlign constant to determine how to vertically align the page on the fax paper.

Boolean FaxPageShrinkIfLarger

Set to True to automatically shrink the page it it is larger than the fax paper size.

Boolean FaxPageAutoRotate

Set as True to automatically rotate the page if it will fit on the fax paper without scaling.

Boolean FaxPageMaintainAspect

Set as True to prevent distortion when scaling larger or smaller pages. When this option is on, the height and width of the page change in relation to one another.

Remarks

Use the following to set these options using SetProperty:

Method Parameter

SetProperty Parameters

FaxProfile

SectionName:

Image Options

PropertyName:

Fax Profile

varValue:

VT_I4, one of the following:

0 = Profile F

1 = Profile S

2 = Profile C

FaxResolution

SectionName:

Image Options

PropertyName:

Fax Resolution

varValue:

VT_I4, one of the following resolutions:

0 = 200 x 100, Profile S, F

1 = 200 x 200, Profile S, F, C

2 = 204 x 98, Profile S, F

3 = 204 x 196, Profile S, F

4 = 300 x 300, Profile F, C

5 = 400 x 400, Profile F, C

6 = 408 x 391, Profile F

7 = 204 x 391, Profile F

8 = 300 x 600, Profile F

9 = 400 x 800, Profile F

10 = 600 x 600, Profile F, C

11 = 600 x 1200, Profile F

12 = 1200 x 1200, Profile F, C

13 = 100 x 100, Profile F, C

FaxPaperWidth

SectionName:

Image Options

PropertyName:

Fax Paper Width

varValue:

VT_I4, one of the following:

0 = Letter

1 = Legal

2 = A4 (ISO)

3 = B4 (ISO)

4 = A3 (ISO)

FaxPaperHeight

SectionName:

Image Options

PropertyName:

Fax Paper Height

varValue:

VT_I4, one of the following:

0 = Variable Height

1 = Fixed Height

FaxPageScaling

SectionName:

Image Options

PropertyName:

Fax Page Scaling

varValue:

VT_I4, one of the following:

0 = Fit to Page

1 = Actual Size

FaxPageHAlign

SectionName:

Image Options

PropertyName:

Fax Page Scaling H Align

varValue:

VT_BSTR, one of the following:

Left

Middle

Right

FaxPageVAlign

SectionName:

Image Options

PropertyName:

Fax Page Scaling V Align

varValue:

VT_BSTR, one of the following:

Top

Middle

Bottom

FaxPageShrinkIfLarger

SectionName:

Image Options

PropertyName:

Fax Page Scaling Shrink Larger

varValue:

VT_BOOL

FaxPageAutoRotate

SectionName:

Image Options

PropertyName:

Fax Page Scaling Auto Rotate

varValue:

VT_BOOL

FaxPageMaintainAspect

SectionName:

Image Options

PropertyName:

Fax Page Scaling Lock Aspect Ratio

varValue:

VT_BOOL

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

See Also: SetFaxModeOn SetTIFFAdvancedOptions SetProperty pnFaxProfile pnFaxResolution pnFaxPaperWidth pnFaxPaperHeight pnFaxPageScaling pnFaxPageScalingHAlign pnFaxPageScalingVAlign