←Select platform

FormProgressCallback Delegate

Summary

Optional delegate method that reports the progress of a specific operation and offers the client an opportunity to cancel.

Syntax

C++

public delegate bool FormProgressCallback(  
   int currentPage, 
   int totalPages, 
   int percentage 
)

Public Delegate Function FormProgressCallback( _ 
   ByVal currentPage As Integer, _ 
   ByVal totalPages As Integer, _ 
   ByVal percentage As Integer _ 
) As Boolean

public delegate bool FormProgressCallback(  
   int currentPage, 
   int totalPages, 
   int percentage 
)

Parameters

currentPage
The 1-based index of the current page.

totalPages
The total number of pages.

percentage
A value between 0 and 100 that represents the percent completion of the process.

Return Value

true to continue the process, false to cancel the process.

Example

This example compares a Master Form attribute with a Form attributes.

Imports Leadtools.Forms 
Imports Leadtools.Forms.Recognition 
 
Public Function ProgressCallbackExample(ByVal recognitionEngine As FormRecognitionEngine, ByVal master As FormRecognitionAttributes, _ 
                                        ByVal form As FormRecognitionAttributes) As FormRecognitionResult 
   Return recognitionEngine.CompareForm(master, form, AddressOf MyFormProgressCallback, AddressOf MyPageProgressCallback) 
End Function 
Private Sub MyPageProgressCallback(ByVal data As PageProgressCallbackData) 
   If data.Percentage = 0 Then 
      Console.WriteLine("--------------------------") 
   End If 
 
   Console.WriteLine("Page progress:{0}%", data.Percentage.ToString("000")) 
End Sub 
 
Private Function MyFormProgressCallback(ByVal currentPage As Integer, ByVal totalPages As Integer, ByVal percentage As Integer) As Boolean 
   If percentage = 0 Then 
      Console.WriteLine("--------------------------") 
   End If 
 
   Console.WriteLine("Page:{0}/{1} {2}%", currentPage.ToString("00"), totalPages.ToString("00"), percentage.ToString("000")) 
 
   Return False 
End Function

using Leadtools.Forms; 
using Leadtools.Forms.Recognition; 
using Leadtools.Forms.Ocr; 
using Leadtools.Forms.Processing; 
using Leadtools.Forms.Recognition.Barcode; 
using Leadtools.Forms.Recognition.Ocr; 
 
// Text writer to save the log to  
public FormRecognitionResult ProgressCallbackExample(FormRecognitionEngine recognitionEngine, 
                                                     FormRecognitionAttributes master, 
                                                     FormRecognitionAttributes form) 
{ 
   return recognitionEngine.CompareForm(master, form, MyFormProgressCallback, MyPageProgressCallback); 
} 
private void MyPageProgressCallback(PageProgressCallbackData data) 
{ 
   if (data.Percentage == 0) 
      Console.WriteLine("--------------------------"); 
 
   Console.WriteLine("Page progress:{0}%", data.Percentage.ToString("000")); 
} 
 
private bool MyFormProgressCallback(int currentPage, int totalPages, int percentage) 
{ 
   if (percentage == 0) 
      Console.WriteLine("--------------------------"); 
 
   Console.WriteLine("Page:{0}/{1} {2}%", 
      currentPage.ToString("00"), 
      totalPages.ToString("00"), 
      percentage.ToString("000")); 
 
   return false; 
}