PDF Conversion Options [used with topdf operations]

Parameter Notes
/fileconversiontimeout Limits the amount of time in seconds that can be spent on conversion. A value of zero means waits indefinitely.
/Zoom Sets printing zoom of the worksheet. The allowed value range is from 10 to 400.
/FitToPagesWide Sets number of pages wide the worksheet will be scaled to. This property is ignored if the Zoom property is set.
/FitToPagesTall Sets number of pages tall the worksheet will be scaled to. This property is ignored if the Zoom property is set.
/MergeAttachments Set this flag to true if you want if you want converted pdf attachments to merged to the output pdf file. Otherwise, the converted files will be merged back to the pdf.
/RetainPDFAttachment Set this flag to true if you want the original attachments to be retained in the pdf file after they are merged. This flag only gets picked up if the MergeAttachments flag above is used.
/IncludeDocProps Set this flag if you want the MS Office properties to be transferred to the target pdf document.
/HandoutOrder Sets the handout order, this flag only applies to PowerPoint jobs. The possible values are:
- PRN_PP_HANDOUT_VERTICAL_FIRST,
- PRN_PP_HANDOUT_HORIZONTAL_FIRST
/PPOutPutType Sets the output type, it only works with the PowerPoint files. The possible values are:
Slides = PRN_PP_OUTTYPE_SLIDES
Build slides = PRN_PP_OUTTYPE_BUILDSLIDES
Two slide handouts = PRN_PP_OUTTYPE_TWOSLIDEHANDOUTS
Three slide handouts = PRN_PP_OUTTYPE_THREESLIDEHANDOUTS
Four slide handouts = PRN_PP_OUTTYPE_FOURSLIDEHANDOUTS
Six slide handouts = PRN_PP_OUTTYPE_SIXSLIDEHANDOUTS
Nine slide handouts = PRN_PP_OUTTYPE_NINESLIDEHANDOUTS
Notes= PRN_PP_OUTTYPE_NOTESPAGES
Outline = PRN_PP_OUTTYPE_OUTLINE
/PrintGraphics Sets the graphics setting for printing. Print Full Resolution = PRN_PB_PRINT_GRAPHICS_HIGHRES. Print Low Resolution = PRN_PB_PRINT_GRAPHICS_LOWRES. Print Graphics = PRN_PB_PRINT_GRAPHICS_NONE
/convertbookmarks For MS Word, convert bookmarks
/bookmarkdepth This property will take effect only when the ConvertBookmarks property is set to True. Numbers defining bookmark levels must be equal to or larger than one. Word style names must not repeat in the string. The string must not start or end with the delimiter. When this property is empty, the default style mapping (Heading one through nine will be mapped to level one through nine) will be used. Therefore, an empty string is functionally equivalent to. Heading 1, Heading 2, Hading 3, Heading 4, Heading 5, Heading 6, Heading 7, Heading 8, Heading 9
Note: If you use a non-English version of Microsoft Word, then you may need to replace the word “Heading” with its localized version.
/converthyperlinks Sets the flag to indicate whether to convert Word hyperlinks to PDF hyperlinks.
/printallsheets The flag that indicates whether to print all Excel worksheets or not.
/printbgcolor For files printed via IE Sets the flag that indicates whether to print background color or not when printing.
/Printscale For Visio files, sets the print scale
/ieheader This property modifies Internet Explorer’s header setting.
/iefooter This property modifies Internet Explorer’s footer setting.
/imagecompression If you want a lossless image compression, use PRN_IMAGE_COMPRESS_ZIP (ZIP compression).
/imagedownsizing If this property is set to True, then the resolution of images is reduced to the DPI value specified in the ImageDownsizeResolution property.
/imagejpegquality The allowed value range is from 5 to 100 with 100 being the highest quality.
/imagedownsizeresolution If the ImageDownsizing property is set to True, then the resolution of images is reduced to the DPI value specified in this property.
/fontembedding The option PRN_FONT_EMBED_FULLSET (embedding full set of fonts) will cause a significant increase in PDF file size, especially for CJK font, and therefore not recommended. If you need to embed the font, PRN_FONT_EMBED_SUBSET (embed subset of fonts) will be a better choice.
/fontsubstitution For the PRN_FONT_SUBST_TABLE (use font substitution table) option, you need to configure the substitution table. The table is stored under the “Device Setting” section of the printer driver properties (can be accessed from the Control Panel).
/fontembedastype0 This option is recommended if you have non-standard fonts like barcode font.
/margintop The margin in Inches.
/marginbottom The margin in Inches.
/marginleft The margin in Inches.
/marginright The margin in Inches.
/pagewidth In Inches.
/pageheight In Inches.
/paperorientation PORTRAIT, LANDSCAPE or DEFAULT
/Papersize Word does not use the paper size setting from the printer driver. If you need to change the paper size, use this property instead.  If you need to use a custom paper size, set this property to PRN_MSO_PAPER_CUSTOM, and set the PageWidth and PageHeight properties.

Below is a list of Paper sizes

PRN_MSO_PAPER_10X14 = 010 x 14 in
PRN_MSO_PAPER_11X17 = 111 x 17 in
PRN_MSO_PAPER_A3 = 6A3 297 x 420 mm
PRN_MSO_PAPER_A4 = 7A4 210 x 297 mm
PRN_MSO_PAPER_A4SMALL = 8A4 Small 210 x 297 mm
PRN_MSO_PAPER_A5 = 9A5 148 x 210 mm
PRN_MSO_PAPER_B4 = 10B4 (JIS) 250 x 354 mm
PRN_MSO_PAPER_B5 = 11B5 (JIS) 182 x 257 mm
PRN_MSO_PAPER_CSHEET = 12C size sheet 17 x 22 in
PRN_MSO_PAPER_CUSTOM = 41Custom Paper Size
PRN_MSO_PAPER_DSHEET = 13D size sheet 22 x 34 in
PRN_MSO_PAPER_ENVELOPE10 = 25Envelope #10 4 1/8 x 9 1/2 in
PRN_MSO_PAPER_ENVELOPE11 = 26Envelope #11 4 1/2 x 10 3/8 in
PRN_MSO_PAPER_ENVELOPE12 = 27Envelope #12 4 3/4 x 11 in
PRN_MSO_PAPER_ENVELOPE14 = 28Envelope #14 5 x 11 1/2 in
PRN_MSO_PAPER_ENVELOPE9 = 24Envelope #9 3 7/8 x 8 7/8 in
PRN_MSO_PAPER_ENVELOPEB4 = 29Envelope B4 250 x 353 mm
PRN_MSO_PAPER_ENVELOPEB5 = 30Envelope B5 176 x 250 mm
PRN_MSO_PAPER_ENVELOPEB6 = 31Envelope B6 176 x 125 mm
PRN_MSO_PAPER_ENVELOPEC3 = 32Envelope C3 324 x 458 mm
PRN_MSO_PAPER_ENVELOPEC4 = 33Envelope C4 229 x 324 mm
PRN_MSO_PAPER_ENVELOPEC5 = 34Envelope C5 162 x 229 mm
PRN_MSO_PAPER_ENVELOPEC6 = 35Envelope C6 114 x 162 mm
PRN_MSO_PAPER_ENVELOPEC65 = 36Envelope C65 114 x 229 mm
PRN_MSO_PAPER_ENVELOPEDL = 37Envelope DL 110 x 220 mm
PRN_MSO_PAPER_ENVELOPEITALY = 38Envelope Italy 110 x 230 mm
PRN_MSO_PAPER_ENVELOPEMONARCH = 39Envelope Monarch 3.875 x 7.5 in
PRN_MSO_PAPER_ENVELOPEPERSONAL = 406 3/4 Envelope 3 5/8 x 6 1/2 in
PRN_MSO_PAPER_ESHEET = 14E size sheet 34 x 44 in
PRN_MSO_PAPER_EXECUTIVE = 5Executive 7 1/4 x 10 1/2 in
PRN_MSO_PAPER_FANFOLDLEGALGERMAN = 15German Legal Fanfold 8 1/2 x 13 in
PRN_MSO_PAPER_FANFOLDSTDGERMAN = 16German Std Fanfold 8 1/2 x 12 in
PRN_MSO_PAPER_FANFOLDUS = 17US Std Fanfold 14 7/8 x 11 in
PRN_MSO_PAPER_FOLIO = 18Folio 8 1/2 x 13 in
PRN_MSO_PAPER_LEDGER = 19Ledger 17 x 11 in
PRN_MSO_PAPER_LEGAL = 4Legal 8 1/2 x 14 in
PRN_MSO_PAPER_LETTER = 2Letter 8 1/2 x 11 in
PRN_MSO_PAPER_LETTERSMALL = 3Letter Small 8 1/2 x 11 in
PRN_MSO_PAPER_NOTE = 20Note 8 1/2 x 11 in
PRN_MSO_PAPER_QUARTO = 21Quarto 215 x 275 mm
PRN_MSO_PAPER_STATEMENT = 22Statement 5 1/2 x 8 1/2 in
PRN_MSO_PAPER_TABLOID = 23Tabloid 11 x 17 in
/PrintColorType

With this property, you can set the PowerPoint to print either with

  • Color: PRN_PP_PRINT_COLOR

  • Grayscale: PRN_PP_PRINT_GRAYSCALE

  • Black and White: PRN_PP_PRINT_BLACK_AND_WHITE

/queuewaittimeout Since PowerPoint cannot perform multiple conversions at the same time, each conversion request will be put into a queue, and they are converted one at a time. Awaiting print job will timeout if it waits for more than the value specified in QueueWaitTimeout property. The timeout value is in milliseconds. Set to zero if you want to wait indefinitely. /disablescriptdebugger Enables/Disables Internet Explorer's script debugger. It is highly recommended that Internet Explorer's script debugger is turned off during printing so that the PDF conversion process is not interrupted. /DisplayErrorDialogOnEveryError Enables/Disables Internet Explorer's error dialog displayed on every error. It is highly recommended that this feature is turned off from Internet Explorer so that the PDF conversion process is not interrupted. /pdfa The output file will be PDF/A-1b compliant. /pdfx1a The output file will be PDF/X-1a compliant. /pdfx3 The output file will be PDF/X-3 compliant. /ConvertAttachments For msg files, email attachments are processed so that the resulting PDF is composed of the email plus each page of each attachment. /IncludeDocumentMarkups The “Include Document Markups” option allows Word comments and markup to be included in the generated PDF. /RevisionMode

The default selection is PRN_DEFAULT_REVISION, meaning the current revision mode that is set inside Word will be used.

Specify PRN_INLINE_REVISION to use inline/strikethrough revision mode and use PRN_BALLOON_REVISION to choose balloon revision mode.

Used in conjunction with Include Document Markup

Word revision mode constants:

0Use the revision mode currently set inside Word
1Inline/strikethrough revision mode (strikethrough used for deletions and underlining used for insertions)
2Balloon revision mode (displays revisions in balloons in the margins)
/SmartShrinking Enables/disables intelligent content shrinking. This is only valid when using the HTMLExtension method. /AutoAdjustPaperSize

A value of True means that easyPDF ensures that no content gets cropped. If needed, it automatically adjusts the paper width, depending on the layout. The paper size will never get smaller than what you specify.

If you enable AutoAdjustPaperSize, SmartShrinking is ignored. You may either shrink the content to fit the page, or extend the page to fit the content, but not both.

/PrintView Gets/Sets the flag that indicates whether to render the document the same way as the Print Preview when converting HTML to PDF. /WaitTimeAfterPageIsLoaded

When an HTML page contains JavaScript, it is often necessary to wait for the JavaScript execution to complete before the document is converted. The purpose of this property is to introduce such a wait.

Default is 200ms

/HighQualityModeForGraphics

The default value is False, which means Microsoft Office prints certain images dithered, as if the output device was an actual ink and paper printer.

Set this property to true to request high quality RGB graphics, with no dithering, which is more appropriate for PDF files intended for computer screens.