2.4.257 Setup

The Setup record specifies the page format settings used to print the current sheet.

iPaperSize (2 bytes):  An unsigned integer that specifies the paper size. Refer to the following table for values. The value 0, or values greater than or equal to 256, specify custom printer paper sizes. Values between 118 and 255 are reserved for future use. If fNoPls is 1, this value is undefined and MUST be ignored.

Value	Meaning
1	US Letter 8 1/2 x 11 in
2	US Letter Small 8 1/2 x 11 in
3	US Tabloid 11 x 17 in
4	US Ledger 17 x 11 in
5	US Legal 8 1/2 x 14 in
6	US Statement 5 1/2 x 8 1/2 in
7	US 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 (JIS) 250 x 354
13	B5 (JIS) 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	US Note 8 1/2 x 11 in
19	US Envelope #9 3 7/8 x 8 7/8
20	US Envelope #10 4 1/8 x 9 1/2
21	US Envelope #11 4 1/2 x 10 3/8
22	US Envelope #12 4 \276 x 11
23	US Envelope #14 5 x 11 1/2
24	C size sheet
25	D size sheet
26	E size sheet
27	Envelope DL 110 x 220mm
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	US Envelope Monarch 3.875 x 7.5 in
38	6 3/4 US 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
42	B4 (ISO) 250 x 353 mm
43	Japanese Postcard 100 x 148 mm
44	9 x 11 in
45	10 x 11 in
46	15 x 11 in
47	Envelope Invite 220 x 220 mm
48	RESERVED--DO NOT USE
49	RESERVED--DO NOT USE
50	US Letter Extra 9 \275 x 12 in
51	US Legal Extra 9 \275 x 15 in
52	US Tabloid Extra 11.69 x 18 in
53	A4 Extra 9.27 x 12.69 in
54	Letter Transverse 8 \275 x 11 in
55	A4 Transverse 210 x 297 mm
56	Letter Extra Transverse 9\275 x 12 in
57	SuperA/SuperA/A4 227 x 356 mm
58	SuperB/SuperB/A3 305 x 487 mm
59	US Letter Plus 8.5 x 12.69 in
60	A4 Plus 210 x 330 mm
61	A5 Transverse 148 x 210 mm
62	B5 (JIS) Transverse 182 x 257 mm
63	A3 Extra 322 x 445 mm
64	A5 Extra 174 x 235 mm
65	B5 (ISO) Extra 201 x 276 mm
66	A2 420 x 594 mm
67	A3 Transverse 297 x 420 mm
68	A3 Extra Transverse 322 x 445 mm
69	Japanese Double Postcard 200 x 148 mm
70	A6 105 x 148 mm
71	Japanese Envelope Kaku #2
72	Japanese Envelope Kaku #3
73	Japanese Envelope Chou #3
74	Japanese Envelope Chou #4
75	Letter Rotated 11 x 8 1/2 11 in
76	A3 Rotated 420 x 297 mm
77	A4 Rotated 297 x 210 mm
78	A5 Rotated 210 x 148 mm
79	B4 (JIS) Rotated 364 x 257 mm
80	B5 (JIS) Rotated 257 x 182 mm
81	Japanese Postcard Rotated 148 x 100 mm
82	Double Japanese Postcard Rotated 148 x 200 mm
83	A6 Rotated 148 x 105 mm
84	Japanese Envelope Kaku #2 Rotated
85	Japanese Envelope Kaku #3 Rotated
86	Japanese Envelope Chou #3 Rotated
87	Japanese Envelope Chou #4 Rotated
88	B6 (JIS) 128 x 182 mm
89	B6 (JIS) Rotated 182 x 128 mm
90	12 x 11 in
91	Japanese Envelope You #4
92	Japanese Envelope You #4 Rotated
93	PRC 16K 146 x 215 mm
94	PRC 32K 97 x 151 mm
95	PRC 32K(Big) 97 x 151 mm
96	PRC Envelope #1 102 x 165 mm
97	PRC Envelope #2 102 x 176 mm
98	PRC Envelope #3 125 x 176 mm
99	PRC Envelope #4 110 x 208 mm
100	PRC Envelope #5 110 x 220 mm
101	PRC Envelope #6 120 x 230 mm
102	PRC Envelope #7 160 x 230 mm
103	PRC Envelope #8 120 x 309 mm
104	PRC Envelope #9 229 x 324 mm
105	PRC Envelope #10 324 x 458 mm
106	PRC 16K Rotated
107	PRC 32K Rotated
108	PRC 32K(Big) Rotated
109	PRC Envelope #1 Rotated 165 x 102 mm
110	PRC Envelope #2 Rotated 176 x 102 mm
111	PRC Envelope #3 Rotated 176 x 125 mm
112	PRC Envelope #4 Rotated 208 x 110 mm
113	PRC Envelope #5 Rotated 220 x 110 mm
114	PRC Envelope #6 Rotated 230 x 120 mm
115	PRC Envelope #7 Rotated 230 x 160 mm
116	PRC Envelope #8 Rotated 309 x 120 mm
117	PRC Envelope #9 Rotated 324 x 229 mm
118	PRC Envelope #10 Rotated 458 x 324 mm

iScale (2 bytes):  An unsigned integer that specifies the scaling factor for printing as a percentage. For example, if the value is 107 then the scaling factor is 107%. If fNoPls is 1, this value is undefined and MUST be ignored.

iPageStart (2 bytes):  A signed integer that specifies the starting page number. If fUsePage is 0, MUST be ignored.

iFitWidth (2 bytes):  An unsigned integer that specifies the number of pages the sheet width is fit to. MUST be less than or equal to 32767. The value 0 means use as many pages as necessary to print the columns in the sheet.

iFitHeight (2 bytes):  An unsigned integer that specifies the number of pages the sheet height is fit to. MUST be less than or equal to 32767. The value 0 means use as many pages as necessary to print the rows of the sheet.

A - fLeftToRight (1 bit):  A bit that specifies the order that multiple pages are sent to the printer for a single sheet.

Value	Meaning
0	Pages are printed top-to-bottom first and then left-to-right.
1	Pages are printed left-to-right first and then top-to-bottom.

B - fPortrait (1 bit):  A bit that specifies whether to print using portrait mode or landscape mode. If fNoPls is 1, the value is undefined and MUST be ignored. If fNoOrient is 1, the value is undefined and MUST be ignored.

Value	Meaning
0	Pages are printed using landscape mode.
1	Pages are printed using portrait mode.

C - fNoPls (1 bit):  A bit that specifies whether the iPaperSize, iScale, iRes, iVRes, iCopies, fNoOrient, and fPortrait data are undefined and ignored. If the value is 1, they are undefined and ignored.

D - fNoColor (1 bit):  A bit that specifies whether the document is printed in black and white.

E - fDraft (1 bit):  A bit that specifies whether the document is printed using draft quality.

F - fNotes (1 bit):  A bit that specifies whether comments are printed.

G - fNoOrient (1 bit):  A bit that specifies whether the paper orientation is set.

Value	Meaning
0	Paper orientation is specified by the value of fPortrait.
1	Pages are printed using portrait mode.

H - fUsePage (1 bit):  A bit that specifies whether a custom starting page number is used to print. If the value is 1, the custom starting page number specified by the value of iPageStart is used.

I - unused1 (1 bit):  Undefined and MUST be ignored.

J - fEndNotes (1 bit):  A bit that specifies whether the comments are printed at the end of the sheet. If fNotes is 0, the value MUST be ignored.

Value	Meaning
0	Comments are printed as displayed on the sheet.
1	Comments are printed at the end of the sheet.

K - iErrors (2 bits):  An unsigned integer that specifies how to handle errors in the cell data. MUST be a value from the following table:

Value	Meaning
0	Print errors as displayed on the sheet.
1	Print errors as blank.
2	Print errors as dashes ("--").
3	Print errors as "#N/A".

L - reserved (4 bits): MUST be zero, and MUST be ignored.

iRes (2 bytes):  An unsigned integer that specifies the print resolution in dots per inch (DPI). If fNoPls is 1, this value is undefined and MUST be ignored.

iVRes (2 bytes):  An unsigned integer that specifies the vertical print resolution in DPI. If fNoPls is 1, this value is undefined and MUST be ignored.

numHdr (8 bytes): An Xnum (section 2.5.342) value that specifies the header margin in inches. The value MUST be greater than or equal to 0 and less than 49.

numFtr (8 bytes): An Xnum value that specifies the footer margin in inches. The value MUST be greater than or equal to 0 and less than 49.

iCopies (2 bytes):  An unsigned integer that specifies the number of copies to print. If fNoPls is 1, this value is undefined and MUST be ignored.