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).

[C++Builder] imagekitcontrolname->Scan->XResolution [ = int ]

[Delphi] imagekitcontrolname.Scan.XResolution [ = Integer ]

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 vikScanNONUI. When the UiMode property is NOT vikScanNONUI 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 GetCapEnumToFloat or the GetCapRange 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 Execute method.

Setting this value

This value can be set at runtime.

Retrieving this value

This value can be retrieved at runtime.