Share via


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