Printer_SetDestination()

Examples


The Printer_SetDestination() function changes the default printer for the current application to the one specified in the printer_settings parameter.

Syntax

Printer_SetDestination(printer_settings)

Parameters

printer_settings – A text field containing the printer-related options selected by the user when the named printer was defined.

Return value

A boolean value indicating whether the current printer was changed. True indicates the current printer was changed. False indicates it wasn’t.

Comments

This function can be useful if you are creating a custom application for which the reports must always be printed to a specific printer.

Use this function with caution. It changes the default printer setting for the current application, not just the current report.


Instead of using this function to change the application’s default printer destination, we suggest you specify named printers only on a report-by-report basis. This can be done using the printer clause of the run report or run report with name statement.


Documentation Feedback