XResolution (ImageKit Control/ Scan Property)

This property sets the horizontal scan resolution. This property is only enabled when using a custom-built user interface (UiMode=2).

[Visual Basic] imagekitcontrolname.Scan.XResolution [ = Long ]

[Visual C++] [ long = ]imagekitcontrolname.GetScan().GetXResolution()
imagekitcontrolname.GetScan().SetXResolution(long Val)

[VB.NET] imagekitcontrolname.Scan.XResolution [ = Integer ]

[C#.NET] imagekitcontrolname.Scan.XResolution [ = int ]

Property Value

The horizontal and vertical scan resolution are set in DPI units.

XResolution is the horizontal scan resolution

Explanation

The XResolution property sets the horizontal scan resolution. This property is enabled when the UiMode property is 2 (ikScanNONUI). When the UiMode property is NOT 2 or when a digital camera is being used, these properties are disabled. The resolution values supported by the scan device can be retrieved by executing the GetCapEnum, the GetCapEnumVariant, the GetCapRange, or the GetCapRangeVariant method. To use the scan device default resolution values, set this property to -1.

Note: Although it is possible to set different values for the horizontal and vertical resolution, some datasources (scanner drivers) do not support different values for horizontal and vertical resolution. In such cases, either the horizontal resolution or the vertical resolution will be enabled. To retrieve the actual resolution, refer to the XResolution and YResolution properties within the BeforeScan event or after executing the Exec or the ExecVariant method.

Setting this value

This value can be set at runtime.

Retrieving this value

This value can be retrieved at runtime.