paperSource

Type: Integer

The paperSource property of the Printer class contains the location in the printer of the paper tray that you want to use for your printed output so that you can use different paper for a part of a document.

You can change the paperSource property dynamically, to allow allocation of the paper source to be used on a page-by-page basis. Changing this property causes a newPage method to be issued if the print is not at the start of a new page before the paperSource property is changed.

As this property is not supported by all printers, the value of this property is printer driver-specific; that is, different printer models may support different paper sources. (For example, your printer driver may assign 256 to an upper tray, 257 to a lower tray, and 4 to manual feed.) The default value of zero (0) indicates that all paper sources are displayed in the common Print dialog.

For a printer with no paper sources defined, the paperSource property is ignored. This is the case for some PDF printer drivers, for example.

The code fragment in the following example shows the use of the paperSource property to print output to the manual feeder.

app.printer.paperSource := 4;

Use the Printer class getAllPaperSources method to access the valid paper sources of a printer and the getDefaultPaperSource method to return the default paper source that is set for the printer.

For details about retaining the setting of this property when the printer is closed, see the Printer class retainCMDValues property.