revShowPrintDialog

Controls display of the Page Setup (on Mac OS) and Print dialog boxes when using the revPrintField or revPrintText commands.

# Metadata

Platforms: desktop OS: mac, windows Introduced: 1.0 Security: printing

# Syntax

revShowPrintDialog showPageSetup, showPrint

# Params

- showPageSetup : - showPrint :

# Examples

revShowPrintDialog true,true -- shows both dialogs

revShowPrintDialog false,true -- shows only Print dialog

revShowPrintDialog false,the hilite of button "Set Options"

# Description

Use the revShowPrintDialog command to let users specify options for printing.

Before printing, applications usually display a dialog box where the user can set certain print-related properties. (This dialog is displayed by the operating system, not by LiveCode.) Typically, the options in the dialog box include enlargement or reduction, landscape or portrait mode, and paper size, but the exact options are determined by the printer driver and the operating system. If you use the revShowPrintDialog command in a handler before a revPrintField or revPrintText command, these commands display this dialog box.

>*Cross-platform note:* On Mac OS and OS X, the > showPageSetup parameter controls whether the Page Setup dialog box> appears, and the showPrint parameter controls whether the > Print dialog box appears. On Windows systems, the showPageSetup > parameter controls whether the standard printing options dialog box> appears, and the showPrint parameter is ignored.

If you use the revShowPrintDialog command outside a handler where a revPrintField or revPrintText command is execute, the revShowPrintDialog command has no effect. The command sets printing options only for the currently execute handler.

>*Important:* The revShowPrintDialog command is part of the > Printing library. To ensure that the command works in a > standalone application, you must include this > LiveCode custom library when you create your > standalone application. In the Inclusions pane of the > Standalone Application Settings window, make sure the "Printing" > library checkbox is checked.

# Tags

printing,

# See

- **message:** startup, openBackground, preOpenStack, openStack, preOpenCard - **command:** answer printer, revPrintText, group, revPrintField, answer page setup - **function:** result - **glossary:** application, standalone application, dialog box, execute, command, Windows, main stack, OS X, Standalone Application Settings, Mac OS, message, parameter, handler, LiveCode custom library - **library:** Printing library