| **Navigation:**  [[introduction.htm|Language Reference]] > 13 - Built-in Functions >====== PRINTERDIALOGA (PRINTERDIALOG variant for opened report) ====== | [[printerdialog  return chosen printer .htm|{{btn_prev_n.gif|Previous page}}]][[introduction.htm|{{btn_home_n.gif|Return to chapter overview}}]][[pushastrings.htm|{{btn_next_n.gif|Next page}}]] |
|  ||

**PRINTERDIALOGA(** [//title//] [,//flag//] [,//prn//] **)**

{{blk2blue.jpg|blk2blue.jpg}}

| **PRINTERDIALOGA** | Displays the Windows standard printer choice dialog box to allow the user to select or configure a printer. |
| //title// | A string constant or variable containing the title to place on the file choice dialog. If omitted, a default //title// is supplied by Windows. |
| //flag// | A numeric constant or variable which displays a target Print dialog based on the flag's value: |
|  | 0 = //Choose Printer// dialog |
|  | 1 = //Print Setup// dialog |
|  | 2 = //Page Setup// dialog |
| //prn// | A label or reference to an opened REPORT or built-in variable PRINTER |

The **PRINTERDIALOGA** procedure displays the Windows standard printer choice dialog box, Print Setup dialog, or Page Setup dialog based on the //flag// value and returns the printer chosen by the user in the PRINTER "built-in" variable in the internal library. This sets the default printer used for the next REPORT opened. Optionally, this variant of PRINTERDIALOG aallows you to invoke the Print and the Printer Setup dialogs for an opened report. If the last parameter is omitted, **PRINTERDIALOGA **is identical to **PRINTERDIALOG**, or** **if the second parameter is set to 2.

PRINTERDIALOGA returns zero (0) if the user pressed the Cancel button, or one (1) if the user pressed the Ok button on the dialog.

**Return Data Type:     **SIGNED

**Example:**

**CustRpt REPORT,AT(1000,1000,6500,9000),THOUS,FONT('Arial',12),PRE(Rpt)**

**         !Report structures and controls**

**        END**

** CODE**

**!Initialization code here**

**OPEN(CustRpt)**

**!Choose printer for opened CustRpt**

** IF NOT ****PRINTERDIALOGA****('Choose Printer',0,CustRpt)**

**  RETURN                 !Abort if user pressed Cancel**

** END**

** **

**See also:** [[printerdialog  return chosen printer .htm|PRINTERDIALOG]]