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 |
|
||||||
FaxResolution |
|
||||||
FaxPaperWidth |
|
||||||
FaxPaperHeight |
|
||||||
FaxPageScaling |
|
||||||
FaxPageHAlign |
|
||||||
FaxPageVAlign |
|
||||||
FaxPageShrinkIfLarger |
|
||||||
FaxPageAutoRotate |
|
||||||
FaxPageMaintainAspect |
|
Supported Printers: TIFF Image Printer, PDF Image Printer, Raster Image Printer
See Also: SetFaxModeOn SetTIFFAdvancedOptions SetProperty pnFaxProfile pnFaxResolution pnFaxPaperWidth pnFaxPaperHeight pnFaxPageScaling pnFaxPageScalingHAlign pnFaxPageScalingVAlign