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 Visual Basic, replace 0x with &H. In Visual Basic the following constants can be used:(ikScanCompression = 0x0100, ikScanPixelType = 0x0101, ikScanUnits = 0x0102, ikScanTransferMode = 0x0103, ikScanFeederEnabled = 0x1002, ikScanFeederLoaded = 0x1003, ikScanIndicator = 0x100b, ikScanUiControllable = 0x100e, ikScanDeviceonline = 0x100f, ikScanThumbnailsEnabled = 0x1011, ikScanDuplex = 0x1012, ikScanEnableDSUIOnly = 0x1014, ikScanCustomDSData = 0x1015, ikScanBrightness = 0x1101, ikScanContrast = 0x1103, ikScanGamma = 0x1108, ikScanHalfTone = 0x1109, ikScanHighlight = 0x110a, ikFileScanFormat = 0x110c, ikScanDropoutColor = 0x110e, ikScanOrientation = 0x1110, ikScanShadow = 0x1113, ikScanXResolution = 0x1118, ikScanYResolution = 0x1119, ikScanRotation = 0x1121, ikScanPaperSize = 0x1122, ikScanThreshold = 0x1123, ikScanXScaling = 0x1124, ikScanYScaling = 0x1125, ikScanBitDepthReduction = 0x112c, ikScanUndefinedImagesize = 0x112d, ikScanImageDataset = 0x112e, ikScanImageFilter = 0x1147, ikScanNoiseFilter = 0x1148, ikScanOverScan = 0x1149, ikScanBorderDetection = 0x1150, ikScanDeskew = 0x1151, ikScanJpegQuality = 0x1153, ikScanScanningSpeed = 0xf001, ikScanMoirefilter = 0xf002, ikScanMoirefilterMaxResolution = 0xf003, ikScanSharpness = 0xf004, ikScanRotateBack = 0xf005, ikScanExtUiMode = 0xf006, ikScanDynamicThreshold = 0xf007, ikScanPixelAutomationCap = 0xf008, ikScanMultiStream = 0xf009, ikScanTextOrientationRecognition = 0xf00a, ikScanSkipBlankPage = 0xf00b, ikScanRemoveHole = 0xf00c, ikScanFocusPosition = 0xf00d, ikScanTextEnhancement = 0xf00e) |
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 (nonzero) when successful, returns False (0) 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 DsName property must be set. If the DsName property is blank then prior to executing this method, please execute the Select method. (If the OpenDS method has been executed, the DsName 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 OpenDS 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.
For scripting languages and other programs that require variant types, please refer to the GetCapRangeVariant method.
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 GetCapEnum or the GetCapEnumVariant 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 from the ImageKit7 ActiveX]
Rotation, Sharpness, SkipBlankPage, and FocusPosition values have
been added to CapNo