UnitOfMeasure Property (Device)

In This Topic

Gets or sets the unit of measure for current scan session.

Syntax

Visual Basic
C#
Managed Extensions for C++
C++/CLI

'Declaration

Public Property UnitOfMeasure As UnitOfMeasure

public UnitOfMeasure UnitOfMeasure { get; set; }

public: __property UnitOfMeasure get_UnitOfMeasure();
public: __property void set_UnitOfMeasure(
   UnitOfMeasure value
);

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

Exceptions

Exception	Description
TwainInvalidStateException	Thrown if device is in wrong state.
TwainDeviceCapabilityException	Thrown if device does not support capability.
DebuggerException	Thrown if the .NET debugger is used and the function evaluation requires all threads to run.

Remarks

Call this property only when device is opened (State == DeviceState.Opened).

Supported pages sizes can be received by the GetSupportedUnitsOfMeasure method.

This property has effect only if you do not use User Interface (ShowUI=False).

Example

This C#/VB.NET code shows how to acquire part of color image with 200 dpi from the device.

VB.NET


Public Sub ScanColorImage(device As Vintasoft.Twain.Device)
        device.ShowUI = False
        device.ShowIndicators = False
        device.DisableAfterAcquire = True

        device.Open()
        device.PixelType = Vintasoft.Twain.PixelType.RGB
        device.UnitOfMeasure = Vintasoft.Twain.UnitOfMeasure.Inches
        device.Resolution = New Vintasoft.Twain.Resolution(200F, 200F)
        device.ImageLayout.[Set](1F, 1F, 5F, 5F)

        device.Acquire()
End Sub


public void ScanColorImage(Vintasoft.Twain.Device device)
{
    device.ShowUI = false;
    device.ShowIndicators = false;
    device.DisableAfterAcquire = true;

    device.Open();
    device.PixelType = Vintasoft.Twain.PixelType.RGB;
    device.UnitOfMeasure = Vintasoft.Twain.UnitOfMeasure.Inches;
    device.Resolution = new Vintasoft.Twain.Resolution(200f, 200f);
    device.ImageLayout.Set(1f, 1f, 5f, 5f);

    device.Acquire();
}

Requirements

Target Platforms: .NET 8, .NET 7; .NET 6; .NET Framework 4.8, 4.7, 4.6, 4.5, 4.0, 3.5

Reference

Device Class
Device Members

GetSupportedUnitsOfMeasure
Open

Send Feedback