'Declaration
 
Public Overloads Function TwainAcquireToFile( _
   ByVal FilePath As String, _
   ByVal HANDLE As IntPtr _
) As GdPictureStatus

public GdPictureStatus TwainAcquireToFile( 
   string FilePath,
   IntPtr HANDLE
)

public function TwainAcquireToFile( 
    FilePath: String;
    HANDLE: IntPtr
): GdPictureStatus; 

public function TwainAcquireToFile( 
   FilePath : String,
   HANDLE : IntPtr
) : GdPictureStatus;

public: GdPictureStatus TwainAcquireToFile( 
   string* FilePath,
   IntPtr HANDLE
) 

public:
GdPictureStatus TwainAcquireToFile( 
   String^ FilePath,
   IntPtr HANDLE
) 

Parameters

FilePath

The path of the image file to create.

HANDLE

A Window Handle IE: Me.Handle. In most applications you can use nothing but on Citrix and WTS, this must be a top-level window or a child of a top level window.

Return Value

By default, the default data source (DS) is opened, displays its dialog, and determines all the parameters of the acquisition and transfer.

If you want to (try to) hide the DS dialog, see TwainSetHideUI.

Before using this method check that the TWAIN state is >= 4 (TWAIN_SOURCE_OPEN)

To get the TWAIN state, use the TwainGetState() method.

To set the TWAIN state to 4, use the TwainOpenDefaultSource() or TwainOpenSource() method.

Warning: To works, this method requires that the current Data source allows file transfer mode.

Use the TwainIsFileTransferModeAvailable() to check if the source support this mode of transfer.

The output image format should be negotiated with the TwainSetImageFileFormat() method.

The output image compression should be negotiated with the TwainSetCompression() method.

This method requires the Document Capture (TWAIN / WIA) component to run.

Reference

GdPictureImaging Class
GdPictureImaging Members
Overload List
TwainGetState Method
TwainLastXferFail Method
TwainUserClosedSource Method
TwainSetHideUI Method
TwainOpenDefaultSource(Int32) Method
TwainSetImageFileFormat Method
TwainSetCompression Method
TwainIsFileTransferModeAvailable Method