PRTINFO( ) Function
Returns the current specified printer setting.
PRTINFO(nPrinterSetting [, cPrinterName])
Parameters
- nPrinterSetting
Specifies which Visual FoxPro printer setting to return. The following table lists descriptions of the type of printer settings returned.nPrinterSetting FOXPRO.H Setting returned 1 PRT_ORIENTATION Paper orientation 2 PRT_PAPERSIZE Paper size 3 PRT_PAPERLENGTH Paper length in .1 millimeter increments 4 PRT_PAPERWIDTH Paper width in .1 millimeter increments 5 PRT_SCALE Factor by which printer output is scaled 6 PRT_COPIES Number of copies to print 7 PRT_DEFASOURCE Default paper source 8 PRT_PRINTQUAL A positive value that indicates the horizontal resolution in dots per inch (DPI) or a negative value that indicates the print quality. 9 PRT_COLOR A value that indicates if a color printer rends color or monochrome output 10 PRT_DUPLEX Duplex mode 11 PRT_YRESOLUTION The vertical resolution in dots per inch (DPI). If not available, a value of -1 is returned. 12 PRT_TTOPTION A value that indicates how TrueType® fonts are printed 13 PRT_COLLATE A value that indicates if output is collated - cPrinterName
Specifies the name of the printer for which information is returned. If cPrinterName is omitted, information is returned for the default printer.
Return Values
Numeric data type. The following tables list values returned when specifying particular values for nPrinterSetting.
If nPrinterSetting is 1, PRTINFO( ) returns the paper orientation as the following:
| Return values | Paper orientation |
|---|---|
| –1 | Information not available |
| 0 | Portrait |
| 1 | Landscape |
If nPrinterSetting is 2, PRTINFO( ) returns the paper size as the following:
| Return values | Paper size |
|---|---|
| –1 or value other than listed | Information not available. Use nPrinterSetting = 3 and nPrinterSetting = 4 to return the paper size. |
| 1 | Letter, 8 1/2 x 11 in |
| 2 | Letter Small, 8 1/2 x 11 in |
| 3 | Tabloid, 11 x 17 in |
| 4 | Ledger, 17 x 11 in |
| 5 | Legal, 8 1/2 x 14 in |
| 6 | Statement, 5 1/2 x 8 1/2 in |
| 7 | Executive, 7 1/4 x 10 1/2 in |
| 8 | A3, 297 x 420 mm |
| 9 | A4, 210 x 297 mm |
| 10 | A4, Small 210 x 297 mm |
| 11 | A5, 148 x 210 mm |
| 12 | B4, 250 x 354 mm |
| 13 | B5, 182 x 257 mm |
| 14 | Folio, 8 1/2 x 13 in |
| 15 | Quarto, 215 x 275 mm |
| 16 | 10 x 14 in |
| 17 | 11 x 17 in |
| 18 | Note, 8 1/2 x 11 in |
| 19 | Envelope #9, 3 7/8 x 8 7/8 in |
| 20 | Envelope #10, 4 1/8 x 9 1/2 in |
| 21 | Envelope #11, 4 1/2 x 10 3/8 in |
| 22 | Envelope #12, 4 1/2 x 11 in |
| 23 | Envelope #14, 5 x 11 1/2 in |
| 24 | C size sheet |
| 25 | D size sheet |
| 26 | E size sheet |
| 27 | Envelope DL, 110 x 220 mm |
| 28 | Envelope C5, 162 x 229 mm |
| 29 | Envelope C3, 324 x 458 mm |
| 30 | Envelope C4, 229 x 324 mm |
| 31 | Envelope C6, 114 x 162 mm |
| 32 | Envelope C65, 114 x 229 mm |
| 33 | Envelope B4, 250 x 353 mm |
| 34 | Envelope B5, 176 x 250 mm |
| 35 | Envelope B6, 176 x 125 mm |
| 36 | Envelope, 110 x 230 mm |
| 37 | Envelope Monarch, 3 7/8 x 7.5 in |
| 38 | 6 3/4 Envelope, 3 5/8 x 6 1/2 in |
| 39 | US Std Fanfold, 14 7/8 x 11 in |
| 40 | German Std Fanfold, 8 1/2 x 12 in |
| 41 | German Legal Fanfold, 8 1/2 x 13 in |
If nPrinterSetting is 7, PRTINFO( ) returns the default paper source as the following:
| Return values | Default paper source |
|---|---|
| 1 | Upper bin |
| 2 | Lower bin |
| 3 | Middle bin |
| 4 | Manual feed |
| 5 | Envelope bin |
| 6 | Manual feed envelope |
| 7 | Automatic feed |
| 8 | Tractor feed |
| 9 | Small format |
| 10 | Large format |
| 11 | Large capacity |
| 14 | Cassette |
| 15 | Default input bin (automatically select) |
If nPrinterSetting is 8 and PRTINFO( ) returns a negative value, the return value indicates the print quality as the following:
| Return values | Print quality |
|---|---|
| –1 | Draft |
| –2 | Low |
| –3 | Medium |
| –4 | High |
If nPrinterSetting is 9, PRTINFO( ) returns a value indicating if a color printer renders color or monochrome output as the following:
| Return values | Color of output |
|---|---|
| 1 | Monochrome |
| 2 | Color |
If nPrinterSetting is 10, PRTINFO( ) returns the duplex mode as the following:
| Return values | Duplex mode |
|---|---|
| 1 | Simplex printing |
| 2 | Vertical duplex |
| 3 | Horizontal duplex |
If nPrinterSetting is 12, PRTINFO( ) returns a value that indicates how TrueType® fonts are printed as the following:
| Return values | Printing of TrueType® fonts |
|---|---|
| 1 | Print as bitmapped graphics |
| 2 | Download as soft fonts |
| 3 | Substitute device fonts |
If nPrinterSetting is 13, PRTINFO( ) returns a value that indicates if output is collated as the following:
| Return values | Collation |
|---|---|
| 0 | No collation |
| 1 | Collated |
Remarks
Visual FoxPro printer settings are set in the Page Setup dialog box. Choose Page Setup from the File menu to display the Visual FoxPro Page Setup dialog box.
See Also
GETPRINTER( ) | PRINTSTATUS( ) | SET DEVICE | SET PRINTER | SYS(13) – Printer Status | SYS(1037) – Page Setup Dialog Box