WebBrowserPreference Property

Gets/Sets the HTML to PDF conversion preferences.

Type

prnWebBrowserPreference

Default Value

PRN_IE_DIRECT_PRINT (for compatibility with easyPDF SDK 6.x)

Remarks

Printer.PrintJob is the central dispatcher in the Printer SDK. It automatically detects the type of the document and forwards it to a specific print job implementation.

Originally PrintJob was fairly straightforward. For .DOC and .TXT, it used WordPrintJob. For .XLS, it chose ExcelPrintJob. For .HTML, it dispatched to IEPrintJob.

However, over time the Printer SDK grew to the point that HTML documents can be converted to PDF in multiple different ways. For example:

• An .HTML file can be printing directly from Internet Explorer using IEPrintJob.
• Or the rendering can be captured from Internet Explorer using IEExtendedPrintJob.

It makes sense to set this preference in PrintJob, which is exactly why WebBrowserPreference exists. The following choices are valid:

• PRN_IE_DIRECT_PRINT: Print directly from Internet Explorer. This is the same as IEPrintJob. This is the default option, which is compatible with all previous versions of easyPDF SDK.
• 
  
• PRN_IE_EXTENDED_PRINT: Capture PDF from Internet Explorer. This is the same as IEExtendedPrintJob.
• 
  

Note that when you are printing Outlook documents with attachments, the OutlookPrintJob.WebBrowserPreference property is considered. For example, an HTML file attached to an Outlook message can be printed in different ways.

Example Usage

Set oPrinter = CreateObject("easyPDF.Printer.7")
Set oPrintJob = oPrinter.PrintJob

oPrintJob.WebBrowserPreference = PRN_IE_EXTENDED_PRINT
oPrintJob.PrintOut "C:\input1.htm", "C:\output1.pdf" ' Same as IEExtendedPrintJob

oPrintJob.WebBrowserPreference = PRN_IE_DIRECT_PRINT
oPrintJob.PrintOut "C:\input2.htm", "C:\output2.pdf" ' Same as IEPrintJob

oPrintJob.WebBrowserPreference = PRN_IE_EXTENDED_PRINT
oPrintJob.PrintOut "C:\input3.msg", "C:\output3.pdf" ' Same as OutlookPrintJob, but HTML attachments
                                                     ' are printed via IEExtendedPrintJob