This property sets the size of the paper. This property is only enabled when using a custom-built user interface.

[C++Builder]   imagekitcontrolname->Scan->PaperSize [ = short ]
[Delphi]   imagekitcontrolname.Scan.PaperSize [ = Smallint ]

Property Value

Value Explanation Size
0 User defined size
1 A4 210mm x 297mm
2 JIS B5 182mm x 257mm
3 US letter 8.5" x 11.0" (216mm x 280mm)
4 US legal 11.0" x 17.0" (216mm x 356mm)
5 A5 148mm x 210mm
6 ISO B4 250mm x 353mm
7 ISO B6 125mm x 176mm
9 US ledger 11.0" x 17.0" (280mm x 432mm)
10 US executive 7.25" x 10.5" (184mm x 267mm)
11 A3 297mm x 420mm
12 ISO B3 353mm x 500mm
13 A6 105mm x 148mm
14 C4 229mm x 324mm
15 C5 162mm x 229mm
16 C6 114mm x 162mm
17 4A0 1682mm x 2378mm
18 2A0 1189mm x 1682mm
19 A0 841mm x 1189mm
20 A1 594mm x 841mm
21 A2 420mm x 594mm
22 A7 74mm x 105mm
23 A8 52mm x 74mm
24 A9 37mm x 52mm
25 A10 26mm x 37mm
26 ISO B0 1000mm x 1414mm
27 ISO B1 707mm x 1000mm
28 ISO B2 500mm x 707mm
29 ISO B5 176mm x 250mm
30 ISO B7 88mm x 125mm
31 ISO B8 62mm x 88mm
32 ISO B9 44mm x 62mm
33 ISO B10 31mm x 44mm
34 JIS B0 1030mm x 1456mm
35 JIS B1 728mm x 1030mm
36 JIS B2 515mm x 728mm
37 JIS B3 364mm x 515mm
38 JIS B4 257mm x 364mm
39 JIS B6 128mm x 182mm
40 JIS B7 91mm x 128mm
41 JIS B8 64mm x 91mm
42 JIS B9 45mm x 64mm
43 JIS B10 32mm x 45mm
44 C0 917mm x 1297mm
45 C1 648mm x 917mm
46 C2 458mm x 648mm
47 C3 324mm x 458mm
48 C7 81mm x 114mm
49 C8 57mm x 81mm
50 C9 40mm x 57mm
51 C10 28mm x 40mm
52 US statement 5.5" x 8.5" (140mm x 216mm)
53 Business card 90mm x 55mm
1000 Undefined

The following constants can be used: vikScanUserSize = 0, vikScanA4LETTER = 1, vikScanB5LETTER = 2, vikScanUSLETTER = 3, vikScanUSLEGAL = 4, vikScanA5 = 5, vikScanB4 = 6, vikScanB6 = 7, vikScanUSLEDGER = 9, vikScanUSEXECUTIVE = 10, vikScanA3 = 11, vikScanB3 = 12, vikScanA6 = 13, vikScanC4 = 14, vikScanC5 = 15, vikScanC6 = 16, vikScan4A0 = 17, vikScan2A0 = 18, vikScanA0 = 19, vikScanA1 = 20, vikScanA2 = 21, vikScanA4 = 1, vikScanA7 = 22, vikScanA8 = 23, vikScanA9 = 24, vikScanA10 = 25, vikScanISOB0 = 26, vikScanISOB1 = 27, vikScanISOB2 = 28, vikScanISOB3 = 12, vikScanISOB4 = 6, vikScanISOB5 = 29, vikScanISOB6 = 7, vikScanISOB7 = 30, vikScanISOB8 = 31, vikScanISOB9 = 32, vikScanISOB10 = 33, vikScanJISB0 = 34, vikScanJISB1 = 35, vikScanJISB2 = 36, vikScanJISB3 = 37, vikScanJISB4 = 38, vikScanJISB5 = 2, vikScanJISB6 = 39, vikScanJISB7 = 40, vikScanJISB8 = 41, vikScanJISB9 = 42, vikScanJISB10 = 43, vikScanC0 = 44, vikScanC1 = 45, vikScanC2 = 46, vikScanC3 = 47, vikScanC7 = 48, vikScanC8 = 49, vikScanC9 = 50, vikScanC10 = 51, vikScanUSSTATEMENT = 52, vikScanBUSINESSCARD = 53, vikScanUndefinedSize = 1000.

Explanation

The PaperSize property sets the size of the paper. This property is enabled when the  UiMode property is vikScanNONUI. However this property is disabled when using a digital camera. To enable the RectLeft, RectTop, RectRight, and RectBottom properties, set the PaperSize property to 0 or less.


Depending on the datasource (scan driver), using a user defined paper size (0) and setting the scan area, may still result in a start position of the scan being incorrect. If that is the case, please use one of the above constant values (1 or more) for the paper size and set this to a NEGATIVE value. (Please refer to the example code below).


Example Code

(The PaperSize is set to 0 and the scan area is set but the scan position is wrong)

VImageKit1.Scan.UiMode := vikScanNONUI;
VImageKit1.Scan.UnitMode := vikScanCM;
VImageKit1.Scan.PaperSize := 0;
VImageKit1.Scan.RectLeft := 0;
VImageKit1.Scan.RectTop := 0;
VImageKit1.Scan.RectRight := 6.9;
VImageKit1.Scan.RectBottom := 10.2;

(The PaperSize is set to one of the above constants with a NEGATIVE value -> the scan position is correct)

VImageKit1.Scan.UiMode := vikScanNONUI;
VImageKit1.Scan.UnitMode := vikScanCM;
VImageKit1.Scan.PaperSize := -3; //US Letter Size
VImageKit1.Scan.RectLeft := 0;
VImageKit1.Scan.RectTop := 0;
VImageKit1.Scan.RectRight := 6.9;
VImageKit1.Scan.RectBottom := 10.2;

Note: Please set the PaperSize property to a size supported by the datasource (scan driver) or set it to the largest supported paper size. With some datasources the PaperSize property has no effect. Please refer to the scan manufacturer for details.

The possible PaperSize settings supported by a scan device can be retrieved using the GetCapEnumToFloat method. For scan devices that only support a fixed paper size or do not support paper size settings set this property to 0.

When PaperSize is set to "undefined" (1000), the paper size is automatically detected then the document is scanned, however, with scanners that can only detect one dimension (either height or width) there are cases when the automatic detection does not work properly. To find out if "Undefined" paper size is supported by the datasource, please execute the IsCapSupported method.

Setting this value

This value can be set at run-time.

Retrieving this value

This value cannot be retrieved.

Differences between the ImageKit7/8/9

In VCL the constants contain a "v". In ActiveX, the constants are: ikScanUserSize, ikScanA4LETTER, ikScanB5LETTER, ikScanUSLETTER, ikScanUSLEGAL, ikScanA5, ikScanB4, ikScanB6, ikScanUSLEDGER, ikScanUSEXECUTIVE, ikScanA3, ikScanB3, ikScanA6, ikScanC4, ikScanC5, ikScanC6, ikScan4A0, ikScan2A0, ikScanA0, ikScanA1, ikScanA2, ikScanA4, ikScanA7, ikScanA8, ikScanA9, ikScanA10, ikScanISOB0, ikScanISOB1, ikScanISOB2, ikScanISOB3, ikScanISOB4, ikScanISOB5, ikScanISOB6, ikScanISOB7, ikScanISOB8, ikScanISOB9, ikScanISOB10, ikScanJISB0, ikScanJISB1, ikScanJISB2, ikScanJISB3, ikScanJISB4, ikScanJISB5, ikScanJISB6, ikScanJISB7, ikScanJISB8, ikScanJISB9, ikScanJISB10, ikScanC0, ikScanC1, ikScanC2, ikScanC3, ikScanC7, ikScanC8, ikScanC9, ikScanC10, ikScanUSSTATEMENT, ikScanBUSINESSCARD, ikScanMaxSize, ikScanUndefinedSize

 

The ImageKit9 VCL is a product created by Newtone Corporation