ImageScannerFeederConfiguration ImageScannerFeederConfiguration ImageScannerFeederConfiguration Class

Definition

Represents the Feeder scan source of the scanner.

public sealed class ImageScannerFeederConfiguration : IImageScannerFeederConfiguration, IImageScannerFormatConfiguration, IImageScannerSourceConfigurationpublic sealed class ImageScannerFeederConfiguration : IImageScannerFeederConfiguration, IImageScannerFormatConfiguration, IImageScannerSourceConfigurationPublic NotInheritable Class ImageScannerFeederConfiguration Implements IImageScannerFeederConfiguration, IImageScannerFormatConfiguration, IImageScannerSourceConfiguration
Attributes
Windows 10 requirements
Device family
Windows Desktop Extension SDK (introduced v10.0.10240.0)
API contract
Windows.Devices.Scanners.ScannerDeviceContract (introduced v1)

Remarks

This runtime class implements the IImageScannerFormatConfiguration, and IImageScannerSourceConfiguration interfaces.

Properties

ActualResolution ActualResolution ActualResolution

Gets the actual horizontal and vertical scan resolution for the scanner's Feeder, in DPI.

public ImageScannerResolution ActualResolution { get; }public ImageScannerResolution ActualResolution { get; }Public ReadOnly Property ActualResolution As ImageScannerResolution
Value
ImageScannerResolution ImageScannerResolution ImageScannerResolution

The horizontal and vertical resolution, in pixels.

Attributes

AutoCroppingMode AutoCroppingMode AutoCroppingMode

Gets or sets the automatic crop mode.

public ImageScannerAutoCroppingMode AutoCroppingMode { get; set; }public ImageScannerAutoCroppingMode AutoCroppingMode { get; set; }Public ReadWrite Property AutoCroppingMode As ImageScannerAutoCroppingMode
Attributes

Remarks

When automatic detection is enabled on the scanner's Feeder, the automatic crop mode indicates whether to scan one region or multiple regions. When a new scan session starts, the default value is Disabled.

AutoDetectPageSize AutoDetectPageSize AutoDetectPageSize

Gets or sets the page size automatic detection feature for the scanner's Feeder.

public bool AutoDetectPageSize { get; set; }public bool AutoDetectPageSize { get; set; }Public ReadWrite Property AutoDetectPageSize As bool
Value
bool bool bool

True if the page size automatic detection feature is enabled; otherwise False.

Attributes

Remarks

This property can be True only if CanAutoDetectPageSize property is True. When this property is True the PageSize and PageOrientation values are ignored.

Brightness Brightness Brightness

Gets or sets the current brightness level for capturing image data from the scanner's Feeder. At the beginning of a new scan session, this property is set to the DefaultBrightness property.

public int Brightness { get; set; }public int Brightness { get; set; }Public ReadWrite Property Brightness As int
Value
int int int

The current brightness level.

Attributes

Remarks

Your app can set the value of this property to any Int32 value between the MinBrightness and MaxBrightness values, and also relates to the BrightnessStep value with this equation:

Brightness = MinBrightness + (N * BrightnessStep)

where N is a positive integer smaller than or equal to (MaxBrightness - MinBrightness) / BrightnessStep.

The app can return the brightness level to default by setting the value of this property to DefaultBrightness.

If the scanner doesn't allow brightness adjustments, MinBrightness, MaxBrightness and DefaultBrightness are set to the same value-oftentimes 0, the BrightnessStep value is 0, and the app can't set the Brightness property to a value other than DefaultBrightness.

BrightnessStep BrightnessStep BrightnessStep

Gets the step size at which the brightness levels of the data source can be increased or decreased between the minimum and maximum values.

public uint BrightnessStep { get; }public uint BrightnessStep { get; }Public ReadOnly Property BrightnessStep As uint
Value
uint uint uint

The step size to increment or decrement. A typical value is 1.

Attributes

Remarks

If the scanner doesn't allow brightness changes, then the MinBrightness, MaxBrightness and DefaultBrightness are set to the same value-oftentimes 0, and the BrightnessStep is set to 0. Your app can determine if the scan source doesn't support brightness adjustments by reading the BrightnessStep value. If the value is greater than 0, the scan source supports brightness adjustments.

CanAutoDetectPageSize CanAutoDetectPageSize CanAutoDetectPageSize

Returns True if the device can automatically detect at scan time the size of the document pages scanned through the Feeder; otherwise returns False.

public bool CanAutoDetectPageSize { get; }public bool CanAutoDetectPageSize { get; }Public ReadOnly Property CanAutoDetectPageSize As bool
Value
bool bool bool

True if the device can automatically detect at scan time the size of the document pages scanned through the Feeder; otherwise False.

Attributes

CanScanAhead CanScanAhead CanScanAhead

Gets whether the scanner device is capable of scanning ahead from its Feeder.

public bool CanScanAhead { get; }public bool CanScanAhead { get; }Public ReadOnly Property CanScanAhead As bool
Value
bool bool bool

Indicates whether or not the scanner's Feeder can scan ahead.

Attributes

CanScanDuplex CanScanDuplex CanScanDuplex

Gets whether the scanner's Feeder is capable of duplex scanning (scanning both document page sides, front and back). When scanning in duplex mode the same scan settings (such as color mode and scan resolution) are applied to scan both page sides.

public bool CanScanDuplex { get; }public bool CanScanDuplex { get; }Public ReadOnly Property CanScanDuplex As bool
Value
bool bool bool

Indicates whether duplex scanning is available.

Attributes

ColorMode ColorMode ColorMode

Gets or sets the color mode for the scanner's Feeder.

public ImageScannerColorMode ColorMode { get; set; }public ImageScannerColorMode ColorMode { get; set; }Public ReadWrite Property ColorMode As ImageScannerColorMode
Attributes

Remarks

When a new scan session starts, this property is the same as the DefaultColorMode property.

Contrast Contrast Contrast

Sets or gets the current contrast level for capturing image data from the scanner's Feeder. At the beginning of a new scan session this property is set to the DefaultContrast property.

public int Contrast { get; set; }public int Contrast { get; set; }Public ReadWrite Property Contrast As int
Value
int int int

The contrast level.

Attributes

Remarks

Your app can set the value of this property to any Int32 value between the MinContrast and MaxContrast values, and also relates to the ContrastStep value with this equation:

Contrast = MinContrast + (N * ContrastStep)

where N is a positive integer smaller than or equal to (MaxContrast - MinContrast) / ContrastStep.

The app can return the contrast level to default by setting the value of this property to DefaultContrast.

If the scanner doesn't allow contrast adjustments, MinContrast, MaxContrast and DefaultContrast are set to the same value-oftentimes 0, the ContrastStep value is 0, and the app can't set the Contrast property to a value other than DefaultContrast.

ContrastStep ContrastStep ContrastStep

Gets the step size at which the contrast levels of the data source can increase or decrease between the minimum and maximum values.

public uint ContrastStep { get; }public uint ContrastStep { get; }Public ReadOnly Property ContrastStep As uint
Value
uint uint uint

The step size to increment or decrement. The typical value is 1.

Attributes

Remarks

If the scanner doesn't allow contrast changes, then the MinContrast, MaxContrast and DefaultContrast are set to the same value-oftentimes 0, and the ContrastStep value is set to 0. Your app can determine if the scan source doesn't support contrast adjustments by reading the ContrastStep value. If the value is greater than 0, then the scan source supports contrast adjustments.

DefaultBrightness DefaultBrightness DefaultBrightness

Gets the default brightness level for the scanner's Feeder.

public int DefaultBrightness { get; }public int DefaultBrightness { get; }Public ReadOnly Property DefaultBrightness As int
Value
int int int

The default brightness level for the scanner.

Attributes

Remarks

A scan source that doesn't allow brightness adjustments can have MinBrightness, MaxBrightness and DefaultBrightness set to the same value-oftentimes 0, and the BrightnessStep value set to 0.

DefaultColorMode DefaultColorMode DefaultColorMode

Gets the default color mode for the scanner's Feeder.

public ImageScannerColorMode DefaultColorMode { get; }public ImageScannerColorMode DefaultColorMode { get; }Public ReadOnly Property DefaultColorMode As ImageScannerColorMode
Attributes

Remarks

When a new scan session begins, this property chooses the default color mode based on the pixel data types and bit depths that each scanner device supports. This is the order of priority:

  • AutoColor
  • Color
  • Grayscale
  • BlackAndWhite If the scanner device doesn't support any of the standard color modes, the current scan source will be considered unavailable and the app won’t be able to scan from there.

DefaultContrast DefaultContrast DefaultContrast

Gets the default contrast level for the scanner's Feeder.

public int DefaultContrast { get; }public int DefaultContrast { get; }Public ReadOnly Property DefaultContrast As int
Value
int int int

The default contrast level.

Attributes

Remarks

A scan source that doesn't allow contrast adjustments can have MinContrast, MaxContrast and DefaultContrast set to the same value-oftentimes 0, and the ContrastStep value set to 0.

DefaultFormat DefaultFormat DefaultFormat

Gets the default file format for the scanner's Feeder at the beginning of a new scan session.

public ImageScannerFormat DefaultFormat { get; }public ImageScannerFormat DefaultFormat { get; }Public ReadOnly Property DefaultFormat As ImageScannerFormat
Attributes

Remarks

All WIA scanner devices support the Windows Device Independent Bitmap (DIB) format.

By default, these values in this order will be selected based on the file formats the device supports, from the smallest file size (in bytes) to the largest size:

    1. Jpeg
    1. Png
    1. Bitmap

DesiredResolution DesiredResolution DesiredResolution

Gets or sets the horizontal and vertical scan resolution for the scanner's Feeder that the app requests, in DPI.

public ImageScannerResolution DesiredResolution { get; set; }public ImageScannerResolution DesiredResolution { get; set; }Public ReadWrite Property DesiredResolution As ImageScannerResolution
Value
ImageScannerResolution ImageScannerResolution ImageScannerResolution

The horizontal and vertical resolution, in pixels.

Attributes

Remarks

This property value can be MinResolution, MaxResolution, or OpticalResolution. But, if your app sets this value to other resolutions, this property will choose the closest resolution values. See ActualResolution property.

Duplex Duplex Duplex

Indicates whether the scanner's Feeder can scan both document page sides.

public bool Duplex { get; set; }public bool Duplex { get; set; }Public ReadWrite Property Duplex As bool
Value
bool bool bool

Returns True if the Feeder can scan both page sides.

Attributes

Format Format Format

Gets or sets the current file transfer format for image data acquisition from the scanner's Feeder to the client app.

public ImageScannerFormat Format { get; set; }public ImageScannerFormat Format { get; set; }Public ReadWrite Property Format As ImageScannerFormat
Attributes

Remarks

When a new scan session starts, this property is set to the default file format. See the DefaultFormat property on how this is done.

MaxBrightness MaxBrightness MaxBrightness

Gets the maximum brightness level supported by the scanner's Feeder.

public int MaxBrightness { get; }public int MaxBrightness { get; }Public ReadOnly Property MaxBrightness As int
Value
int int int

The maximum brightness level, typically 1000.

Attributes

Remarks

This property's value must be greater than or equal to the value of the MinBrightness property. A scan source that doesn't allow brightness adjustments can have MinBrightness, MaxBrightness and DefaultBrightness set to the same value-oftentimes 0, and the BrightnessStep value set to 0.

MaxContrast MaxContrast MaxContrast

Gets the maximum contrast level supported by the scanner's Feeder.

public int MaxContrast { get; }public int MaxContrast { get; }Public ReadOnly Property MaxContrast As int
Value
int int int

The maximum contrast level, typically 1000.

Attributes

Remarks

This property's value must be greater than or equal to the value of the MinContrast property. A scan source that doesn't allow contrast adjustments can have MinContrast, MaxContrast and DefaultContrast set to the same value-oftentimes 0, and the ContrastStep value set to 0.

MaxNumberOfPages MaxNumberOfPages MaxNumberOfPages

Gets or sets the maximum number of pages-not images, the app can scan in one scan job, before the scanner stops.

public uint MaxNumberOfPages { get; set; }public uint MaxNumberOfPages { get; set; }Public ReadWrite Property MaxNumberOfPages As uint
Value
uint uint uint

The number of pages.

Attributes

Remarks

The default value is 1. If this property is 0, the scanner must scan until the Feeder tray is empty. Each scanned page can produce one or more images. For example when scanning duplex with AutoCroppingMode set to ImageScannerAutoCroppingMode.Disabled there are two images to acquire for each scanned page (one image from the front and another image from the back side of the scanned page).

MaxResolution MaxResolution MaxResolution

Gets the maximum horizontal and vertical scan resolution of the scanner's Feeder in DPI.

public ImageScannerResolution MaxResolution { get; }public ImageScannerResolution MaxResolution { get; }Public ReadOnly Property MaxResolution As ImageScannerResolution
Value
ImageScannerResolution ImageScannerResolution ImageScannerResolution

The horizontal and vertical resolution, in pixels.

Attributes

Remarks

Apps can scan at MaxResolution in a small area at the highest possible resolution.

MaxScanArea MaxScanArea MaxScanArea

Gets the maximum scan area dimensions in inches. The maximum scan width is the widest a document can be in order for the scanner's Feeder to scan it.

public Size MaxScanArea { get; }public Size MaxScanArea { get; }Public ReadOnly Property MaxScanArea As Size
Value
Size Size Size

The width and height of the area.

Attributes

Remarks

For Feeder scan sources, there are restrictions for the maximum scan area:

  • The currently selected page size, if page size auto-detection is not enabled.
  • The dimensions of the selected page size, which becomes the new maximum dimensions of the permissible scan area. These limits are dictated by hardware for Feeder, Flatbed and other types of scan sources.

MinBrightness MinBrightness MinBrightness

Gets the minimum brightness level supported by the scanner's Feeder.

public int MinBrightness { get; }public int MinBrightness { get; }Public ReadOnly Property MinBrightness As int
Value
int int int

The minimum brightness level, typically -1000.

Attributes

Remarks

This property's value must be smaller than or equal to the value of the MaxBrightness property. A scan source that doesn't allow brightness adjustments can have MinBrightness, MaxBrightness and DefaultBrightness set to the same value-oftentimes 0, and the BrightnessStep value set to 0.

MinContrast MinContrast MinContrast

Gets the minimum contrast level supported by the scanner's Feeder.

public int MinContrast { get; }public int MinContrast { get; }Public ReadOnly Property MinContrast As int
Value
int int int

The minimum contrast level, typically -1000.

Attributes

Remarks

This property's value must be smaller than or equal to the value of the MaxContrast property. A scan source that doesn't allow contrast adjustments can have MinContrast, MaxContrast and DefaultContrast set to the same value-oftentimes 0, and the ContrastStep value set to 0.

MinResolution MinResolution MinResolution

Gets the minimum horizontal and vertical scan resolution of the scanner's Feeder in DPI.

public ImageScannerResolution MinResolution { get; }public ImageScannerResolution MinResolution { get; }Public ReadOnly Property MinResolution As ImageScannerResolution
Value
ImageScannerResolution ImageScannerResolution ImageScannerResolution

The horizontal and vertical resolution, in pixels.

Attributes

MinScanArea MinScanArea MinScanArea

Gets the minimum scan area in inches. The minimum scan area is the smallest size a document can have in order for a Feeder to scan it.

public Size MinScanArea { get; }public Size MinScanArea { get; }Public ReadOnly Property MinScanArea As Size
Value
Size Size Size

The width and height of the area.

Attributes

OpticalResolution OpticalResolution OpticalResolution

Gets the optical horizontal and vertical scan resolution of the scanner's Feeder in DPI.

public ImageScannerResolution OpticalResolution { get; }public ImageScannerResolution OpticalResolution { get; }Public ReadOnly Property OpticalResolution As ImageScannerResolution
Value
ImageScannerResolution ImageScannerResolution ImageScannerResolution

The horizontal and vertical scan resolution in pixels.

Attributes

Remarks

Apps can scan at OpticalResolution for the best quality per pixel that the hardware device is capable of.

PageOrientation PageOrientation PageOrientation

Gets or sets the currently selected page orientation that tells how to place the documents in the scanner's Feeder input tray.

public PrintOrientation PageOrientation { get; set; }public PrintOrientation PageOrientation { get; set; }Public ReadWrite Property PageOrientation As PrintOrientation
Value
PrintOrientation PrintOrientation PrintOrientation

The orientation of the page.

Attributes

Remarks

Some devices may not support all orientation values for all PageSize values. For example, a MaxScanArea.Width of 8500 (8.5”) and MaxScanArea.Height of 1100 (11”) can have a PageSize of NorthAmericaLetter and a PageOrientation of Portrait, but can't be Landscape. When the AutoDetectPageSize property is True the scanner device automatically detects at scan time the size of the document pages being scanned and the values of the PageSize and PageOrientation properties are ignored. When the AutoCroppingMode property is SingleRegion or MultipleRegion, the scanner device will detect crop regions (and scan them to separate images) while the Feeder feeds and scans the specified document size.

PageSize PageSize PageSize

Gets or sets the currently selected page size to scan from the Feeder.

public PrintMediaSize PageSize { get; set; }public PrintMediaSize PageSize { get; set; }Public ReadWrite Property PageSize As PrintMediaSize
Attributes

Remarks

When the AutoDetectPageSize property is True the scanner device automatically detects at scan time the size of the document pages to scan and the values of the PageSize and PageOrientation properties are ignored.

When the AutoCroppingMode property is SingleRegion or MultiRegion, the scanner device will detect crop regions (and scan them to separate images) while the Feeder feeds and scans the specified document size.

PageSizeDimensions PageSizeDimensions PageSizeDimensions

Gets the dimensions (width and height) and orientation of the selected page size, in mil units (1/1000").

public Size PageSizeDimensions { get; }public Size PageSizeDimensions { get; }Public ReadOnly Property PageSizeDimensions As Size
Value
Size Size Size

The page size.

Attributes

Remarks

When the AutoDetectPageSize property is False this property describes the dimensions (width and height) and orientation of the page size, in mil (1/1000”) units. For example, a Portrait NorthAmericaLetter having dimensions 8.5" x 11” has a PageSizeDimensions.Width value of 8500 units and a PageSizeDimensions.Height value of 11000 units, while a Landscape NorthAmericaLetter having dimensions 11" x 8.5” has a PageSizeDimensions.Width value of 11000 units and a PageSizeDimensions.Height value of 8500 units.

When the AutoDetectPageSize property is True the value of this property is automatically set to MaximumScanArea.Width and MaximumScanArea.Height and the app should ignore it.

ScanAhead ScanAhead ScanAhead

Indicates whether or not to scan ahead.

public bool ScanAhead { get; set; }public bool ScanAhead { get; set; }Public ReadWrite Property ScanAhead As bool
Value
bool bool bool

True to scan ahead.

Attributes

SelectedScanRegion SelectedScanRegion SelectedScanRegion

Gets or sets the origin coordinates (horizontal and vertical) and dimensions (width and height) of the selected scan area, in inches. This property is ignored when the AutoCroppingMode property is not Disabled.

public Rect SelectedScanRegion { get; set; }public Rect SelectedScanRegion { get; set; }Public ReadWrite Property SelectedScanRegion As Rect
Value
Rect Rect Rect

The scan region, in inches.

Attributes

Remarks

This table describes the property's restrictions. Default values are set at the beginning of a new scan session.

NameDefault valueValid Flatbed valuesValid Feeder values
0between 0 and - 1between 0 and
0between 0 and - 1between 0 and
between and ( – )between and
between and ( – )between and

Methods

IsAutoCroppingModeSupported(ImageScannerAutoCroppingMode) IsAutoCroppingModeSupported(ImageScannerAutoCroppingMode) IsAutoCroppingModeSupported(ImageScannerAutoCroppingMode)

Returns whether the scanner's Feeder supports the specified ImageScannerAutoCroppingMode.

public bool IsAutoCroppingModeSupported(ImageScannerAutoCroppingMode value)public bool IsAutoCroppingModeSupported(ImageScannerAutoCroppingMode value)Public Function IsAutoCroppingModeSupported(value As ImageScannerAutoCroppingMode) As bool
Parameters
Returns
bool bool bool

Indicates whether the device supports value mode.

Attributes

IsColorModeSupported(ImageScannerColorMode) IsColorModeSupported(ImageScannerColorMode) IsColorModeSupported(ImageScannerColorMode)

Returns whether the scanner's Feeder can scan and transfer images in the specified color mode.

public bool IsColorModeSupported(ImageScannerColorMode value)public bool IsColorModeSupported(ImageScannerColorMode value)Public Function IsColorModeSupported(value As ImageScannerColorMode) As bool
Parameters
Returns
bool bool bool

Indicates whether the scanner can scan images in value mode.

Attributes

IsFormatSupported(ImageScannerFormat) IsFormatSupported(ImageScannerFormat) IsFormatSupported(ImageScannerFormat)

Determines whether the scanner's Feeder supports the specified file format or not.

public bool IsFormatSupported(ImageScannerFormat value)public bool IsFormatSupported(ImageScannerFormat value)Public Function IsFormatSupported(value As ImageScannerFormat) As bool
Parameters
Returns
bool bool bool

Indicates whether the specified file type is supported.

Attributes

IsPageSizeSupported(PrintMediaSize, PrintOrientation) IsPageSizeSupported(PrintMediaSize, PrintOrientation) IsPageSizeSupported(PrintMediaSize, PrintOrientation)

Returns whether the Feeder can scan documents in the specified page size and orientation.

public bool IsPageSizeSupported(PrintMediaSize pageSize, PrintOrientation pageOrientation)public bool IsPageSizeSupported(PrintMediaSize pageSize, PrintOrientation pageOrientation)Public Function IsPageSizeSupported(pageSize As PrintMediaSize, pageOrientation As PrintOrientation) As bool
Parameters
pageSize
PrintMediaSize PrintMediaSize PrintMediaSize

The page size.

pageOrientation
PrintOrientation PrintOrientation PrintOrientation

The page orientation.

Returns
bool bool bool

Indicates the scanner can scan with pageSize and pageOrientation values.

Attributes