This method retrieves the range of possible setting values for a specified functionality of the scan device.
Parameters
Value | Explanation |
---|---|
CapNo | The number for the retrieved functionality
(hexadecimal)
0x1101 Brightness 0x1103 Contrast 0x1108 Gamma 0x110a Highlight 0x1113 Shadow 0x1118 Horizontal resolution 0x1119 Vertical resolution 0x1121 Rotation angle 0x1123 Threshold 0x1124 Horizontal scaling 0x1125 Vertical scaling 0x1153 JPEG quality coefficient 0xf004 Sharpness 0xf00b SkipBlankPage 0xf00d FocusPosition In Delphi, replace 0x with $. The following constants can be used:(vikScanBrightness = 0x1101, vikScanContrast = 0x1103, vikScanGamma = 0x1108, vikScanHighlight = 0x110a, vikScanShadow = 0x1113, vikScanXResolution = 0x1118, vikScanYResolution = 0x1119, vikScanRotation = 0x1121, vikScanThreshold = 0x1123, vikScanXScaling = 0x1124, vikScanYScaling = 0x1125, vikScanJpegQuality = 0x1153, vikScanSharpness = 0xf004, vikScanSkipBlankPage = 0xf00b, viikScanFocusPosition = 0xf00d) |
ConType | A variable that retrieves the type of value for the setting (i.e. whether it is an array, a list, a single value, etc) |
Return Value
Returns True when successful, returns False when not successful.
Explanation
The GetCapRange method retrieves the range of possible setting values for a specified functionality of the scan device. To retrieve the range of possible values for a setting, the DataSourceName property must be set. If the DataSourceName property is blank then prior to executing this method, please execute the Select method. (If the OpenDataSource method has been executed, the DataSourceName property is disabled and the open scan device will be used.)
To execute the GetCapRange method you must first execute the Initialize method. If the OpenDataSource method is executed prior to executing the GetCapRange method then the open datasource cannot be used by another application until that datasource (scan device) is closed.
Depending on the scanner being used, it is possible that the range acceptable resolution values will differ according to the pixel type setting (1 bit color or 24 bit color). Because of this, it is recommended that before you retrieve the range of possible XDpi and YDpi values, you first set the PixelType property.
The GetCapRange method corresponds to the Scan Control's ScanGetCapRange method in earlier versions of the ImageKit.
Regarding ConType values
(0: When False (0) is returned, 3: when an array is returned, 4 when a list is returned, 5: when a single value is returned, 6: when a range is returned).
When ConType=3 or 4, then the number of elements in the list is set into the RangeMax property. Use this number and execute the GetCapEnumToFloat method.
When ConType=5, then the current value is set into the RangeCurrent property and the default value is set into the RangeDefault property.
When ConType=6, then values are set into the RangeCurrent, RangeDefault, RangeMax, RangeMin, and RangeStep properties.
Differences with ImageKit 7/8/9/10 ActiveX
V is added to the beginning of the constant identifier.
Differences from the ImageKit7 ActiveX/VCL
Rotation, Sharpness, SkipBlankPage, and FocusPosition values have been added to CapNo