The 'Setup' method

Argument: None or Boolean Scalar
Result: Boolean scalar

Valid for: Printer

The Setup method displays the standard page-setup dialog, which allows the user to specify document-specific print parameters such as the paper size, paper source, and orientation. (This is the dialog which is normally displayed when the user selects Page Setup.. from the File menu of a typical application). It updates the current print record of the printer object, and should be called before calling the Open method which starts the print job.

Under Windows, there are two versions of this dialog. The default (invoked if you specify no argument, or an argument of 0) is simpler, and does not allow the user to set the page margins. The second (invoked if you specify an argument of 1) does allow the margins to be set by the user. Under MacOS or Linux, the same dialog is shown in both cases.

The return value indicates how the user ended the dialog. If the user pressed the OK button, it returns 1. A return value of 0 indicates that the Cancel button was pressed.

See also the Job method which displays the standard dialog for selecting print-job parameters such as the number of copies.