IKScanGetMinimumSize

This function retrieves the smallest size that can be scanned with a given scan device

[C++Builder/Visual C++] BOOL IKScanGetMinimumSize(HANDLE AppHandle, HANDLE SrcHandle, LPCSTR ScanDsName, WORD ScanMode, WORD UnitMode, float * Width, float * Height);

[Delphi] function IKScanGetMinimumSize(AppHandle, SrcHandle: THandle; ScanDsName: PAnsiChar; ScanMode, UnitMode: Word; var Width, Height: Single): LongBool;

[Visual Basic] Function IKScanGetMinimumSize(ByVal AppHandle As Long, ByVal SrcHandle As Long, ByVal ScanDsName As String, ByVal ScanMode As Integer, ByVal UnitMode As Integer, Width As Single, Height As Single) As Long

Parameters

Name	Explanation
AppHandle	The application handle retrieved by IKScanInitialize
SrcHandle	The scan device handle retrieved by IKScanOpenDS or 0
ScanDsName	The datasource name (Required when SrcHandle is0)
ScanMode	The scan mode (0: document plate (transmissive or reflective), 1: ADF single side (transmissive or reflective), 2: ADF double side (transmissive or reflective))
UnitMode	The scan units (0: inches, 1: centimeters, 2: pica, 3: points, 4: twips, 5: pixels, 6: millimeters)
Width	The minimum width of the scan
Height	The minimum height of the scan

Return Value

Returns True (nonzero) when successful, returns False (0) when not successful.

Explanation

If using the value retrieved from IKScanOpenDS in SrcHandle, then no other application can use the opened datasource (scan device) until the datasource is closed. If SrcHandle is 0 and ScanDsName is blank then you must execute the IKScanSelect function. ("" or null means the datasource selected by IKScanSelect will be used) Please set a value for the UnitMode parameter that is supported by the datasource. The Width and Height values depend on the ScanMode and UnitMode values. However if UnitMode is 5 (pixels) then the Width and Height values will also depend on the current resolution (DPI).

[Differences from the ImageKit7]
IKScanGetMinimumSizeEx was added in the ImageKit8.