InsertFormPage Method

Summary

Appends a new page to the specified Form attributes object. The Form attributes object should be opened before the addition using OpenForm.

Syntax

C++/CLI

Java

Python

public void InsertFormPage( 
   int formPageNumber, 
   FormRecognitionAttributes attributes, 
   RasterImage page, 
   PageRecognitionOptions pageOptions, 
   PageProgressCallback callback 
)

public void insertFormPage( 
   int formPageNumber, 
   FormRecognitionAttributes attributes, 
   RasterImage page, 
   PageRecognitionOptions pageOptions, 
   PageProgressCallback callback 
);

public: 
void InsertFormPage(  
   int formPageNumber, 
   FormRecognitionAttributes^ attributes, 
   RasterImage^ page, 
   PageRecognitionOptions^ pageOptions, 
   PageProgressCallback^ callback 
)

def InsertFormPage(self,formPageNumber,attributes,page,pageOptions,callback):

Parameters

formPageNumber
The One-Based index at which page should be inserted.

attributes
The Form attributes object.

page
The page image that is going to be added to the Form attributes object.

pageOptions
Specifies the options for the page.

callback
Optional callback to show operation progress.

Remarks

The attributes object should be a Form attributes object, this method does not work for Master Forms attributes. To add a page to a Master Form attributes object use AddMasterFormPage(FormRecognitionAttributes,RasterImage,PageRecognitionOptions).

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

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

Example

This example adds a page to the form

Java

using Leadtools; 
using Leadtools.Barcode; 
using Leadtools.Codecs; 
using Leadtools.Forms.Common; 
using Leadtools.Ocr; 
using Leadtools.Forms.Processing; 
using Leadtools.Forms.Recognition; 
using Leadtools.Forms.Recognition.Barcode; 
using Leadtools.Forms.Recognition.Ocr; 
 
/// This method inserts a page to a form attributes object for recognition at the specified index. 
public void InsertFormPage(FormRecognitionEngine recognitionEngine, 
                           RasterImage image, 
                           int index, 
                           FormRecognitionAttributes attributes) 
{ 
   recognitionEngine.OpenForm(attributes); 
   recognitionEngine.InsertFormPage(index, attributes, image, null, null); 
   recognitionEngine.CloseForm(attributes); 
}

 
import static org.junit.Assert.assertTrue; 
 
import java.io.File; 
import java.io.IOException; 
 
import org.junit.*; 
import org.junit.Test; 
import org.junit.runner.JUnitCore; 
import org.junit.runner.Result; 
import org.junit.runner.notification.Failure; 
 
import leadtools.*; 
import leadtools.codecs.*; 
import leadtools.forms.recognition.*; 
 
 
public void insertFormPageExample() { 
   FormRecognitionEngine recognitionEngine = new FormRecognitionEngine(); 
   RasterCodecs codecs = new RasterCodecs(); 
   RasterImage image = codecs 
         .load("C:\\LEADTOOLS23\\Resources\\Images\\Forms\\OMR Processing\\Exam\\Filled\\st1.tif"); 
   int index = 1; 
   FormRecognitionAttributes attributes = recognitionEngine.createForm(null); 
 
   recognitionEngine.insertFormPage(index, attributes, image, null, null); 
   recognitionEngine.closeForm(attributes); 
 
   assertTrue("Incorrect FormRecognitionEngine version", FormRecognitionEngine.getVersion() == 2); 
   System.out.println("Command run, page added successfully"); 
}

Requirements

Target Platforms

Reference

FormRecognitionEngine Class

FormRecognitionEngine Members

Download our FREE evaluation

Help Version 23.0.2024.2.29

Leadtools.Forms.Recognition Assembly

Introduction

Getting Started

Namespaces

Leadtools.Forms.Recognition Namespace

Assemblies