PrintHTML

Description

Prints either specified HTML text or the HTML document specified by the URL using the current printing settings in the same session context. The method is asynchronous. It returns before the document is downloaded and printed.

Important note: The HTML to be printed must not be ‘ScriptX-enabled’ - it must not contain an object tag referencing the ScriptX object nor script code that uses that object. Attempting to print HTML (either specified HTML text or a document specified by url) that contains the ScriptX object can lead to strange errors and failure of the entire printing process, including causing Internet Explorer to stop responding.

PrintHTML may be used to organize a printing queue in a separate process, in which case the current window may be closed without waiting for pending downloads to complete. See OwnQueue for more details.

Syntax

printing.PrintHTML(url[, prompt = false])

Returns false if printing with a prompt and the user cancels the printing.

Parameter Description
url (String) URL/HTML text to print:
Protocol Prints
html:// The HTML is loaded and printed, e.g. html://<html><head><title>Dynamic Printing</title></head><body>Hello world!</body></html>
any other, e.g. http://, https:// or if no protocol specified The document is downloaded and printed. A relative (to the current page) URL may be given.
Note: The target document at 'url' must NOT be ‘ScriptX-enabled’.
prompt [Optional] (Bool) Specifies whether or not the user should be prompted before the download is queued

Examples

The following simple but complete example shows how to print an externally-located document:


The following example illustrates dynamic creation of the HTML to be printed: