This method confirms whether or not a functionality is supported by the datasource (scan device).
Parameters
capability
The number for the retrieved
functionality in hexadecimal (A member ofScanCapability)
Return Value
Returns True if successful. Returns False if unsuccessful.
Explanation
The IsCapabilitySupported method confirms whether or not a functionality is supported by the datasource (scan device). To retrieve the supported range for a functionality, the DataSourceName property must be set. If the DataSourceName property is blank then prior to executing this method, please execute the SelectDataSource method. (If the OpenDataSource method has been executed, the DataSourceName is disabled and the open scan device will be used.
To execute the IsCapabilitySupported method you must first execute the Initialize method. If the OpenDataSource method is executed prior to executing the IsCapSupported method then the open datasource cannot be used by another application until that datasource (scan device) is closed.
After executing this method, the values are set in the Value property.
The values set in the Value property:
| Parameter | The setting value |
|---|---|
| Document feeder function ( FeederEnabled ) | 0: cannot be used (document plate can be used), 1: feeder can be used, 2: both document plate and feeder can be used |
| The function that checks whether or not there is paper in the document feeder ( FeederLoaded ) | 0: there is no paper, 1: there is paper |
| Indicator | 0: cannot use indicator, 1: can use indicator |
| UI control function ( UIControllable ) | 0: must use manufacturer's UI only, 1: manufacturer's UI can be suppressed |
| The function that checks device's operating state ( DeviceOnline ) | 0: Device does not respond, 1: Device is operating |
| the function that transfers thumbnail images ( ThumbnailEnabled ) | 0: cannot transfer thumbnails, 1: can transfer thumbnails |
| Duplex scanning with the document feeder is supported ( Duplex ) | 0: 0: can not scan both sides, 1: can scan both sides at once, 2: can scan both sides but takes two scans |
| EnableDataSourceOnly | 0: Cannot display setting interface, 1: Setting interface can be displayed |
| CustomDataSourceData | 0: Not possible to retrieve or set UI value, 1: Can retrieve or set value in UI |
| Automatic Brightness (AutoBright) | 0: Automatic brightness cannot be used, 1: Automatic brightness can be used. |
| The undefined size ( UndefinedImageSize ) | In general, 0: undefined size cannot be used, 1: undefined size
can be used. However, with certain Epson scan drivers the following values are set, 0: undefined size cannot be used, 1: possible only with document plate, 2: possible only with ADF, 3: possible with both document plate and ADF |
| How many images are in a digital camera( ImageDataSet ) | the returned number is the number of images |
| BorderDetection | 0: border detection is not possible, 1: border detection is possible |
| Deskew | 0: cannot use deskew, 1: can use deskew, 2: can use deskew with
smoothing 2 is only available for certain Panasonic scan drivers. In that case, 1 can be used. |
| The maximum resolution when using a moire filter ( MoireFilterMaxResolution ) | the value is that maximum resolution Available only for certain Epson scan drivers |
| RotateBack when using ADF in duplex mode ( RotateBack ) | 0: rotating the back side is not possible, 1: rotating the back
side is possible Available only for certain Canon DR and Epson "Epson Scan" scan drivers |
| Automatically detecting ratio of BW/Color ( PixelAutomation ) | 0: cannot automatically detect BW/Color, 1: can automatically
detect BW/Color Available only for certain Panasonic, Canon DR, and PFU (Fujitsu) scan drivers |
| MultiStream | 0: multi-stream is not possible, 1: multi-stream is
possible (Multi-stream is where 1 scan of the document plate results in retrieving two images of different pixel types) Available only for certain Panasonic scan drivers |
| TextOrientationRecognition or Automatic rotation | 0: Cannot use remove punch hole, 1: Remove punch hole is
possible Available only for certain Canon DR or Panasonic scan drivers. Canon DR scan drivers use "Text Orientation Recognition" whereas Panasonic scan drivers use "Automatic Image Orientation". |
| Punch hole removal (RemoveHole) | 0: Automatic orientation based on text or automatic rotation is
not possible, 1: Automatic orientation based on text or automatic
rotation is possible. Available only for certain Canon DR, Epson, PFU, or Panasonic scan drivers. |
| Border adjustment (Border) | 0: Cannot adjust border, 1: Can adjust border Available only for certain Epson or Panasonic scan drivers |
| Gamma adjustment (AdjustGamma) | 0: Cannot adjust gamma, 1: Can adjust gamma. Available only for certain Epson scan drivers. |
If the return value of the IsCapabilitySupported method is False, then -1 is set in the Value property.
See Also
Scan Members | Newtone.ImageKit.Win.ImageKit