Public Function AcquireSimple( _
   ByVal version As WiaVersion, _
   ByVal owner As IWin32Window, _
   ByVal item As Object, _
   ByVal deviceType As WiaDeviceType, _
   ByVal flags As WiaAcquireFlags _
) As DialogResult

Visual Basic (Usage)	Copy Code
Dim instance As WiaSession Dim version As WiaVersion Dim owner As IWin32Window Dim item As Object Dim deviceType As WiaDeviceType Dim flags As WiaAcquireFlags Dim value As DialogResult   value = instance.AcquireSimple(version, owner, item, deviceType, flags)

public DialogResult AcquireSimple( 
   WiaVersion version,
   IWin32Window owner,
   object item,
   WiaDeviceType deviceType,
   WiaAcquireFlags flags
)

public:
DialogResult AcquireSimple( 
   WiaVersion version,
   IWin32Window owner,
   Object^ item,
   WiaDeviceType deviceType,
   WiaAcquireFlags flags
) 

Parameters

version

The WIA version to be used. Possible values are:

Value	Meaning
WiaVersion.Version1	Use WIA version 1.0.
WiaVersion.Version2	Use WIA version 2.0.

owner

Window handle of your application window.

item

This parameter is only used when acquiring from a scanner device while the ShowUserInterface flag is NOT set. Use this parameter to specify the scanner’s paper source (Feeder or Flatbed).

This flag is optional. If you are using WIA 1.0 you can change the paper source by changing the WiaPropertyId.ScannerDeviceDocumentHandlingSelect property value for the root item or by enumerating the available scanner items and passing the desired scanner item.

If you are using WIA 2.0, either enumerate the available scanner items and pass the desired scanner item; or pass null (Nothing in Visual Basic), in which case the enumeration will be performed internally and the first enumerated item will be used as the source item.

deviceType

Specifies which type of WIA device to use. Possible values are:

Value	Meaning
WiaDeviceType.Default	Generic WIA device. During device enumerations, this constant is used to enumerate all WIA devices. This is the default value.
WiaDeviceType.Scanner	The device is a scanner.
WiaDeviceType.DigitalCamera	The device is a camera. Note that this type of device is not supported by Windows Vista and later.
WiaDeviceType.StreamingVideo	The device contains streaming video. Note that this type of device is not supported by Windows Server 2003, Windows Vista, or later.

flags

Flag that determines certain actions of the WIA image acquisition selection dialog box. Possible values are:

Value	Meaning
WiaAcquireFlags.None	Default behavior for the device image acquisition dialog box.
WiaAcquireFlags.NoDefault	Force displaying the Select Device dialog box even if there is only one device available.
WiaAcquireFlags.SingleImage	Restrict image selection to a single image in the device image acquisition dialog box. This flag is not available if you are using WIA version 2.0.
WiaAcquireFlags.ShowUserInterface	Show the manufacturer’s image acquisition dialog box.
WiaAcquireFlags.UseCommonUI	Use the system user interface (UI), if available, rather than the vendor-supplied UI. If the system UI is not available, the vendor UI is used.

Return Value

This is a high level acquire function that you can call directly. When using this function, the following functions are called internally:

• WiaSession.Startup
• WiaSession.SelectDeviceDlg
• Shutdown

You can change the AcquireOptions property members before calling this method to control some options while acquiring from the WIA source.

Set this method to perform memory transfer or file transfer by performing one of the following:

• Set the transfer mode through the WiaSession.Properties property and then call the WiaSession.SetProperties method.
• Set the transfer mode by setting the WiaSession.LongValue property to any of the transfer modes available through the WiaTransferMode and then call the WiaSession.SetPropertyLong method, passing WiaPropertyId.ItemTymed for the propertyId parameter of this method.

When performing memory transfer you need to add the WiaSession.AcquireEvent event to receive the acquired page(s). The event will also provide you with the percent completion of the page transfer progress.

When performing file transfer it is optional to add the WiaSession.AcquireEvent event since the event will only provide you with the saved file path and the percent completion of the file saving process.

When performing file transfer two properties within the WiaSession class become available:

• FilesCount - contains the number of files being saved.
• FilesPaths - a collection that contains the saved file paths and filenames.

To cancel the acquire operation, add the WiaSession.AcquireEvent event and set the Cancel member of the WiaAcquireEventArgs to true.

For more information, refer to How to Acquire from the WIA Source.

Target Platforms: Microsoft .NET Framework 3.0, Windows 2000, Windows XP, Windows Vista, Windows Server 2003 family, Windows Server 2008 family

Reference