PRTINFO( ) Function

Visual FoxPro 9.0 SP2

PRTINFO( ) Function

Returns the current specified printer setting.

PRTINFO(nPrinterSetting [, cPrinterName])

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:

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:

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:

If nPrinterSetting is 12, PRTINFO( ) returns a value that indicates how TrueType® fonts are printed as the following:

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.