AcquireToFile Method

Description:

Scans multiple pages from a scanner equipped with an Automatic Document Feeder (ADF).

If FileName specifies only a directory but not a file name, a separate file for each page will be created, using the names 0000001.tif, 00000002.tif, 00000003.tif, etc. If those files already exist, they will be deleted before being scanned into. The name specified by FileName must end with a backslash '\' character in order to be interpreted as a directory.

If FileName specifies a filename and SavePagesSeparately Property is set to True, a separate file for each page will be created, but will use part of the name that you supplied. If the name you supplied was "ScanTest.bmp", your pages will be named as follows: ScanTest1.bmp, ScanTest2.bmp, ScanTest3.bmp ... ScanTest10.bmp, ScanTest11.bmp, etc. If these files already exist, they will be deleted before being scanned into.

If SavePagesSeparately Property is False and FileFormat is set to a format type that supports multiple pages, such as TIFF, DCX, or MO:DCA, the images are stored in one file identified by the FileName parameter.

If SavePageBeforeEvent is True, each image is saved before the AfterPage Event occurs. Otherwise, the images are saved after the AfterPage Event. Use OpenSource Method to select the desired Data Source, and SetCapability Method to set desired capabilities values prior to calling this method. Set UseUI Property to True, prior to calling this method, if you want ImageGear to obtain the capability settings from the end-user.

Syntax:

      AcquireToFile(FileName As String, NumPages As Long, FileFormat
As enumIGSaveFormats)

Parameters:

Name	Description
FileName	The name of the file to scan to.
NumPages	The number of pages to scan. Setting number of pages to -1 results in acquiring all the available pages.
FileFormat	The format of the file to scan to.

Return Value:

N/A