GetFormAlignment(FormRecognitionAttributes,FormRecognitionAttributes,FormProgressCallback,PageProgressCallback) Method

Returns a list of Leadtools.Forms.PageAlignment objects that determines the amount of shift and scaling for each page of the Form with its corresponding page in the specified Master Form.

Syntax

C#
Visual Basic
Objective-C
Java
C++

public IList<PageAlignment> GetFormAlignment( 
   FormRecognitionAttributes masterAttributes,
   FormRecognitionAttributes formAttributes,
   FormProgressCallback formCallback,
   PageProgressCallback pageCallback
)

'Declaration
 
Public Overloads Function GetFormAlignment( _
   ByVal masterAttributes As FormRecognitionAttributes, _
   ByVal formAttributes As FormRecognitionAttributes, _
   ByVal formCallback As FormProgressCallback, _
   ByVal pageCallback As PageProgressCallback _
) As IList(Of PageAlignment)

'Usage
 
Dim instance As FormRecognitionEngine
Dim masterAttributes As FormRecognitionAttributes
Dim formAttributes As FormRecognitionAttributes
Dim formCallback As FormProgressCallback
Dim pageCallback As PageProgressCallback
Dim value As IList(Of PageAlignment)
 
value = instance.GetFormAlignment(masterAttributes, formAttributes, formCallback, pageCallback)

public:
IList<PageAlignment^>^ GetFormAlignment( 
   FormRecognitionAttributes^ masterAttributes,
   FormRecognitionAttributes^ formAttributes,
   FormProgressCallback^ formCallback,
   PageProgressCallback^ pageCallback
)

Parameters

masterAttributes: The Master Form attributes object.
formAttributes: The Form attributes object.
formCallback: Provides status on the progress of the alignment calculations at the form level (i.e. page by page). Set it to null to ignore the progress.
pageCallback: Provides status on the progress of the alignment calculations at the page level. Set it to null to ignore the progress.

Remarks

Alignment is necessary when processing forms so that data can be extracted correctly. This function returns a Leadtools.Forms.PageAlignment object that aligns a Leadtools.Forms.LogicalRectangle located in the Master Form to its equivalent position in the Form.

Example

C#
Visual Basic
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Copy Code

Imports Leadtools
Imports Leadtools.Barcode
Imports Leadtools.Codecs
Imports Leadtools.Forms
Imports Leadtools.Forms.Ocr
Imports Leadtools.Forms.Processing
Imports Leadtools.Forms.Recognition
Imports Leadtools.Forms.Recognition.Barcode
Imports Leadtools.Forms.Recognition.Ocr

'''This method calculates the alignment for the recognized form.
  Public Sub AlignForm(ByVal recognitionEngine As FormRecognitionEngine, _
                       ByVal form As MyForm, _
                       ByVal calculateAlignment As Boolean)
      If calculateAlignment Then
          form.Alignment = recognitionEngine.GetFormAlignment(form.Master.Attributes, _
                                                              form.Attributes, Nothing)
      Else
          form.Alignment = New List(Of PageAlignment)()
          Dim i As Integer = 0
          Do While i < form.Result.PageResults.Count
              form.Alignment.Add(form.Result.PageResults(i).Alignment)
              i += 1
          Loop
      End If
  End Sub

using Leadtools;
using Leadtools.Barcode;
using Leadtools.Codecs;
using Leadtools.Forms;
using Leadtools.Forms.Ocr;
using Leadtools.Forms.Processing;
using Leadtools.Forms.Recognition;
using Leadtools.Forms.Recognition.Barcode;
using Leadtools.Forms.Recognition.Ocr;

///This method calculates the aligmnet for the recognized form.
public void AlignForm(FormRecognitionEngine recognitionEngine, MyForm form, bool calculateAlignment)
{
   if(calculateAlignment)
   {
      form.Alignment = recognitionEngine.GetFormAlignment(form.Master.Attributes, form.Attributes, null);
   }
   else
   {
      form.Alignment = new List<PageAlignment>();
      for(int i = 0; i < form.Result.PageResults.Count; i++)
         form.Alignment.Add(form.Result.PageResults[i].Alignment);
   }
}

Requirements

Target Platforms

Reference

FormRecognitionEngine Class
FormRecognitionEngine Members
Overload List