Optional delegate method that reports the progress of a specific operation and offers the client an opportunity to cancel.
Syntax
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.
Visual Basic | Copy Code |
---|
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 |
C# | Copy Code |
---|
// 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;
} |
Requirements
Target Platforms: Microsoft .NET Framework 2.0, Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7
See Also