Routines (alphabetical) > Routines: D > DIALOG_PRINTJOB

# DIALOG_PRINTJOB

The DIALOG_PRINTJOB function opens a native dialog that allows you to set parameters for a printing job (number of copies to print, for example).

## Syntax

Result = DIALOG_PRINTJOB( [PrintDestination] [, DIALOG_PARENT=widget_id] [, DISPLAY_NAME=string] [, RESOURCE_NAME=string] [, TITLE=string] )

## Return Value

DIALOG_PRINTJOB returns a nonzero value if the user pressed the “OK” button in the dialog, or zero otherwise. You can use the result of this function to programmatically begin printing.

## Arguments

### PrintDestination

An instance of the IDLgrPrinter object for which a printing job is to be initiated. If no PrintDestination is specified, the printer used by the IDL Direct Graphics `printer` device is modified.

## Keywords

### DIALOG_PARENT

Set this keyword to the widget ID of a widget to be used as the parent of this dialog.

### DISPLAY_NAME

Set this keyword to a string indicating the name of the X Windows display on which the dialog is to appear. This keyword is ignored if the DIALOG_PARENT keyword is specified. This keyword is also ignored on Microsoft Windows platforms.

### RESOURCE_NAME

Set this keyword to a string containing an X Window System resource name to be applied to the dialog.

### TITLE

Set this keyword to a string to be displayed on the dialog frame. This keyword is ignored on Microsoft Windows platforms.

Note: You can use language catalogs to internationalize this value with strings in particular languages.

## Version History

5.0 | Introduced

## See Also

DIALOG_PRINTERSETUP