PrtInfo Function | |
-- todo --
Returns the current specified printer setting.
Namespace:
XSharp.VFP
Assembly:
XSharp.VFP (in XSharp.VFP.dll) Version: 2.19
Syntax FUNCTION PrtInfo(
nPrinterSetting,
cPrinterName
) AS LONG CLIPPER
[ClipperCallingConventionAttribute(new string[] { ... })]
public static int PrtInfo(
Usual nPrinterSetting = default,
Usual cPrinterName = default
)
Request Example
View SourceParameters
- nPrinterSetting (Optional)
- Type: Usual
Specifies which X# printer setting to return. The table in the remarks section lists descriptions of the type of printer settings returned.
- cPrinterName (Optional)
- Type: Usual
Specifies the name of the printer for which information is returned. If cPrinterName is omitted, information is returned for the default printer.
Return Value
Type:
Long
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 X# printer settings in the printer Page Setup dialog box. For more information, see Page Setup Dialog Box.
nPrinterSetting | XSHARP.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 |
See Also