SaveToOneFile Property

Gets or sets a flag that indicates whether to save multiple pages to a single file.

Syntax

Visual Basic
C#
WinRT C#
WinRT JavaScript
C++

public bool SaveToOneFile {get; set;}

'Declaration
 
Public Property SaveToOneFile As Boolean

'Usage
 
Dim instance As WiaAcquireOptions
Dim value As Boolean
 
instance.SaveToOneFile = value
 
value = instance.SaveToOneFile

public bool SaveToOneFile {get; set;}

 get_SaveToOneFile();
 set_SaveToOneFile(value);

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

Property Value

Flag that indicates whether to save multiple pages to a single file. Possible values are: true to save to a single file, false to save acquired pages to separate files. The default value is false.

Remarks

Note: This member is ignored when using WIA version 2.0.

If the SaveToOneFile member is set to false and also the WiaAcquireOptions.OverwriteExisting member is set to false, the acquire functions will generate a new file for each acquired page from the device by generating new names of the name you specified through the WiaAcquireOptions.FileName member by adding "(N)" to the end of the file name where N represents an incremented number. If the new name currently exists it will keep generating new names until it finds a new one. If the OverwriteExisting member is set to true then the acquire functions will generate a new name and check whether it exists. If it does it overwrites that file.

Example

Refer to WiaSession.AcquireToFile example.

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

WiaAcquireOptions Structure
WiaAcquireOptions Members