PRTINFO( ) Function

  • Article

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