YResolution (ImageKit Control/ Scan Property)

This property sets the vertical scan resolution. This property is only enabled when using a custom-built user interface.

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

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

Property Value

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

YResolution is the vertical scan resolution

Explanation

The YResolution property sets the vertical 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, this property is 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 YResolutionproperties 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.