CHOOSEPRINTER( )

Topic group Related topics

Opens a printer setup dialog box. Returns false if you cancel out of the dialog, true otherwise.

Syntax

CHOOSEPRINTER([<title expC>][, <expL>])

<title expC>

Optional custom title for the printer setup dialog box.

<expL>

If true, CHOOSEPRINTER( ) will display the "Print Setup" dialog.

If false, CHOOSEPRINTER( ) will display the standard "Print" dialog.”

Description

Use CHOOSEPRINTER( ) to open a printer setup dialog box, which lets you change the current printer or printer options.

p = chooseprinter()

? p

// opens the printer setup dialog; p = false only if the dialog is canceled

chooseprinter ("Tip: For 2-sided printing, see Options, Paper/Output options")

// opens the printer setup dialog with a printing tip in the title

If you use CHOOSEPRINTER( ) to switch printers, SET PRINTER TO, _pdriver, _plength, and _porientation will automatically point to the new printer.

To activate a specific printer driver, you can also use _pdriver.

Menu equivalent: File | Print opens the Print dialog, which offers a printer selection list and properties dialog for the selected printer.

The CHOOSEPRINTER( ) function is maintained only for backward compatibility. We suggest using the printer object for the _app or reports.

_app.printer.choosePrinter() //sets the default printer

report.printer.choosePrinter()//sets the printer for that instance of the report