AcquireMultiPage Event

Summary

(Document/Medical only) Occurs twice for each scanned page, if the EnableAcquireMultiPageEvent property is set to true.

Syntax

C++/CLI

Python

public event EventHandler<TwainAcquireMultiPageEventArgs> AcquireMultiPage

public: 
event EventHandler<TwainAcquireMultiPageEventArgs^>^ AcquireMultiPage

def AcquireMultiPage(sender,e): # sender: TwainSession e: TwainAcquireMultiPageEventArgs

Event Data

The event handler receives an argument of type TwainAcquireMultiPageEventArgs containing data related to this event. The following TwainAcquireMultiPageEventArgs properties provide information specific to this event.

Property	Description
Cancel	Set to true to abort the acquire operation.
FileName	Indicates the filename into which the current multipage scanning operation is saving pages that are acquired.
FinishScan	Gets a value that represents the status of the scanning process.
PageNumber	Indicates the current page number of the scan.

Remarks

This event will be fired two times. The event is fired the first time when the TWAIN source begins scanning the page. The event is fired the second time when the TWAIN source has finished scanning the page. For more information, refer to How to Acquire from the Twain Source.

Example

using Leadtools; 
using Leadtools.Twain; 
 
 
public void twain_AcquireMulti(object sender, TwainAcquireMultiPageEventArgs e) 
{ 
   string msg; 
 
   if (e.FinishScan) 
   { 
      msg = String.Format("The page # {0} is scanned and saved to file name {1}", e.PageNumber, e.FileName); 
      MessageBox.Show(msg); 
   } 
 
   e.Cancel = false; 
} 
 
public void AcquireFastExample(IntPtr parent) 
{ 
   TwainSession session = new TwainSession(); 
   session.Startup(parent, "manufacturer", "productFamily", "version", "application", TwainStartupFlags.None); 
 
   session.EnableAcquireMultiPageEvent = true; 
   session.AcquireMultiPage += new EventHandler<TwainAcquireMultiPageEventArgs>(twain_AcquireMulti); 
 
   session.AcquireFast(Path.Combine(LEAD_VARS.ImagesDir, "Out_test.tif"), 
                       TwainFastUserInterfaceFlags.Show, 
                       TwainTransferMode.Buffer, 
                       RasterImageFormat.Tif, 1, true, 0, true); 
   session.Shutdown(); 
} 
 
static class LEAD_VARS 
{ 
   public const string ImagesDir = @"C:\LEADTOOLS23\Resources\Images"; 
}