# AG\_WINPTR

> [HTML Version](ag_winptr.htm)

_Reviewed and revised December 2023_

**tab(-10, AG\_WINPTR); chr(127);**     [Tab(-10,x) Syntax Notes](ag_xxx_syntax-notes.htm.md)

AG\_WINPTR (56) brings up the Windows printer selection dialog.

This function has both a [subroutine and a print tab implementation](subroutine-print-pairs.htm.md).

**Response**

A string containing four or more comma-delimited parameters depending on the circumstances and user response, i.e.: 

_status, ptrname\$, port\$, dvr\$ \{, orientation, length, width, form, duplex, bin, color, quality_\} CR

**Example**

Selecting the PDF-XChange Printer 2012 will return something like:

1,PDF-XChange Printer 2012,PDF-XChange5,winspool,1,0,0,Letter/ANSI A,0,0,2,300

The first parameter, _status_, will be 1 if the user selected a printer, else 0 

See [MX\_WINPTR](mx_winptr.htm.md)[xs](keyword-types.htm.md) for the definitions of the remaining parameters. 

Note that since ATE and A-Shell/Windows versions prior to 6.0.1248.0 will only return the first four fields, and that INPUT will continue to prompt for parameters that were not supplied. It is therefore best to input the entire string as a single line, as shown above, and then parse it out, perhaps using [INSTR()](instr().htm.md) or STRTOK[xs](keyword-types.htm.md) Using [MX\_WINPTR](mx_winptr.htm.md)[xs](keyword-types.htm.md) will take care of all the parsing automatically. 

**See Also**

•	[MX\_WINPTR](mx_winptr.htm.md)[xs](keyword-types.htm.md)

**History**

2012 April, A-Shell 6.0.1248:  Added all parameters after "PTRDVR\$"