ImageScannerFlatbedConfiguration.DesiredResolution Property

Definition

Namespace:

Windows.Devices.Scanners

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

public:
 property ImageScannerResolution DesiredResolution { ImageScannerResolution get(); void set(ImageScannerResolution value); };

ImageScannerResolution DesiredResolution();

void DesiredResolution(ImageScannerResolution value);

public ImageScannerResolution DesiredResolution { get; set; }

var imageScannerResolution = imageScannerFlatbedConfiguration.desiredResolution;
imageScannerFlatbedConfiguration.desiredResolution = imageScannerResolution;

Public Property DesiredResolution As ImageScannerResolution

Property Value

ImageScannerResolution

The horizontal and vertical resolution, in pixels.

Implements

DesiredResolution

Remarks

The actual resolution used for scanning (see ActualResolution) will be set to the closest resolution supported by the scanner.

Scanners support either:

• A fixed list of resolutions (for example, 75x75dpi, 150x150dpi, 300x300dpi, 450x450dpi, and 600x600dpi), or
• A resolution range between MinResolution and MaxResolution in resolution-step increments. For example, 75x75dpi up to 600x600dpi, in increments of 25dpi.

For the fixed list example above, setting DesiredResolution to 125x125dpi (for example) would result in an ActualResolution of 150x150dpi being used for scanning, because that's the closest match in that example list of supported resolutions (rounding up, if equidistant from supported resolution values).

For the resolution range example above, setting DesiredResolution to 130x130dpi (for example) would result in an ActualResolution of 125x125dpi being used for scanning, because that's the closest supported matching resolution in that example range.

You can also set DesiredResolution to OpticalResolution.

See also

• ActualResolution