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 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.

See Also

Reference

GETPRINTER( ) Function

PRINTSTATUS( ) Function

SET DEVICE Command

SET PRINTER Command

SYS(13) - Printer Status

SYS(1037) - Page Setup Dialog Box

Other Resources

Functions