←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#
VB
C++
Java
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 interface FormProgressCallback 
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.

C#
VB
using Leadtools.Forms.Common; 
using Leadtools.Forms.Recognition; 
using Leadtools.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; 
} 
Imports Leadtools.Forms.Common 
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 

Requirements

Target Platforms

See Also

Reference

FormProgressCallback Members

Leadtools.Forms.Common Namespace

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