ONPRINT

From iMacros
Revision as of 19:22, 30 March 2020 by Mf (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

Handles print dialogs. The ONPRINT command must appear before the PRINT command which triggers the printer dialog to come up.

Syntax iMacros Browser IE Plug-in

ONPRINT P=n BUTTON=(PRINT|CANCEL)

or introduced in version 12.6, the ONPRINT command can accept the extra parameter SAVEAS to indicate where the print output file should be saved:

 ONPRINT P=n BUTTON=(PRINT|CANCEL) SAVEAS=path_to_print_output_file

Parameters

  • P
    Specifies the number of the printer to use in the drop down list. If you use only P= or P=* the most recently selected printer is used. Typically this is the default windows printer.
    Related forum post: How to determine the printer number.
  • Button
    Specifies the button on the Print dialog. By default the PRINT button is selected. With CANCEL the dialog is canceled and no page is printed. The CANCEL option is useful if you want to cancel a print dialog that was triggered by a website automatically.
  • SAVEAS
    First introduced in iMacros version 12.6
    Specifies the path where the print output file should be saved if the chosen printer creates such a file output as .pdf or .xps files.

Examples

Select the third printer in the list and print the page:

URL GOTO=https://imacros.net
ONPRINT P=3 
PRINT

Cancel a Print dialog that appears:

 ONPRINT P=* BUTTON=CANCEL
 URL GOTO=javascript:print()

Save the .xps output file (introduced in v. 12.6):

 ONPRINT P=4 SAVEAS=c:\temp\testprinter.xps

Remarks

The ONPRINT command to print to a file can only handle printing the top frame of the document on the browser. If a document has more than one frame, a number of other saveas dialogs (as many as sub-frames in the document) will be shown and remain unhandled. While it is possible to handle one of these saveas dialogs with the ONDOWNLOAD command, the subsequent ones will remain unhandled.

See Also

PRINT