←Select platform

AcquireMultiPage Event

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

Syntax
C#
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.

PropertyDescription
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
C#
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"; 
} 
Requirements

Target Platforms

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Twain Assembly
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.