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 Value
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
You can set Visual FoxPro printer settings in the printer Page Setup dialog box. For more information, see Page Setup Dialog Box.