LEADTOOLS Forms (Leadtools.Forms.Recognition assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.29
InsertMasterFormPage Method
See Also 
Leadtools.Forms.Recognition Namespace > FormRecognitionEngine Class : InsertMasterFormPage Method



masterFormPageNumber
The One-Based index at which page should be inserted.
attributes
The Master Form attributes object.
page
The page image that is going to be added to Master Form attributes object.
pageOptions
Specifies the page options.
callback
Optional callback to show operation progress.

The InsertMasterFormPage Method is available as an add-on to the LEADTOOLS Document and Medical Imaging toolkits.

masterFormPageNumber
The One-Based index at which page should be inserted.
attributes
The Master Form attributes object.
page
The page image that is going to be added to Master Form attributes object.
pageOptions
Specifies the page options.
callback
Optional callback to show operation progress.
Appends a new page to the specified Master Form attributes object. The Master Form attributes object should be opened before the addition using FormRecognitionEngine.OpenMasterForm.

Syntax

Visual Basic (Declaration) 
Public Sub InsertMasterFormPage( _
   ByVal masterFormPageNumber As Integer, _
   ByVal attributes As FormRecognitionAttributes, _
   ByVal page As RasterImage, _
   ByVal pageOptions As PageRecognitionOptions, _
   ByVal callback As PageProgressCallback _
) 
Visual Basic (Usage)Copy Code
Dim instance As FormRecognitionEngine
Dim masterFormPageNumber As Integer
Dim attributes As FormRecognitionAttributes
Dim page As RasterImage
Dim pageOptions As PageRecognitionOptions
Dim callback As PageProgressCallback
 
instance.InsertMasterFormPage(masterFormPageNumber, attributes, page, pageOptions, callback)

Parameters

masterFormPageNumber
The One-Based index at which page should be inserted.
attributes
The Master Form attributes object.
page
The page image that is going to be added to Master Form attributes object.
pageOptions
Specifies the page options.
callback
Optional callback to show operation progress.

Example

For a complete example of using form recognition and processing, refer to the FormRecognitionEngine example.

This example adds a page to the master form

Visual BasicCopy Code
''' This method inserts a page to a Master Form recognition attributes object at the specified index.
Public Sub InsertMasterPage(ByVal recognitionEngine As FormRecognitionEngine, ByVal image As RasterImage, ByVal index As Integer, ByVal attributes As FormRecognitionAttributes)
    recognitionEngine.OpenMasterForm(attributes)
    recognitionEngine.InsertMasterFormPage(index, attributes, image, Nothing, Nothing)
    recognitionEngine.CloseMasterForm(attributes)
End Sub
C#Copy Code
/// This method inserts a page to a Master Form recognition attributes object at the specified index.
public void InsertMasterPage(FormRecognitionEngine recognitionEngine, RasterImage image, int index, FormRecognitionAttributes attributes)
{
   recognitionEngine.OpenMasterForm(attributes);
   recognitionEngine.InsertMasterFormPage(index, attributes, image, null, null);
   recognitionEngine.CloseMasterForm(attributes);
}

Remarks

The attributes object should be a Master Form attributes object, this method does not work for Forms attributes object. To add a page to a Form attributes object use FormRecognitionEngine.AddFormPage.

If formPageNumber is equal to -1 the page will be appended to the form pages.

If formPageNumber is greater than the number of form pages an exception is thrown.

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

Leadtools.Forms requires a Forms Module license and unlock key. For more information, refer to: Imaging Pro/Document/Medical Features