Leadtools.Forms.Ocr Requires Document/Medical product license | Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
Save(Stream,OcrDocumentFormat,OcrProgressCallback) Method
See Also 
Leadtools.Forms.Ocr Namespace > IOcrDocument Interface > Save Method : Save(Stream,OcrDocumentFormat,OcrProgressCallback) Method



stream
The .NET stream to save the final output document to.
format
The document format to use.
callback
Optional callback to show operation progress.
stream
The .NET stream to save the final output document to.
format
The document format to use.
callback
Optional callback to show operation progress.
(Deprecated) Converts the cumulated recognition result stored in the pages of this OCR document to the final output document and stores it in a .NET stream.

Syntax

Visual Basic (Declaration) 
Overloads Overridable Sub Save( _
   ByVal stream As Stream, _
   ByVal format As OcrDocumentFormat, _
   ByVal callback As OcrProgressCallback _
) 
Visual Basic (Usage)Copy Code
Dim instance As IOcrDocument
Dim stream As Stream
Dim format As OcrDocumentFormat
Dim callback As OcrProgressCallback
 
instance.Save(stream, format, callback)
C# 
virtual void Save( 
   Stream stream,
   OcrDocumentFormat format,
   OcrProgressCallback callback
)
C++/CLI 
virtual void Save( 
   Stream^ stream,
   OcrDocumentFormat format,
   OcrProgressCallback^ callback
) 

Parameters

stream
The .NET stream to save the final output document to.
format
The document format to use.
callback
Optional callback to show operation progress.

Example

For an example, refer to IOcrDocumentManager and IOcrEngine.

Remarks

(Deprecated) Use IOcrDocument.Save(Stream, DocumentFormat, OcrProgressCallback) instead.

To save the output document to a disk file, use IOcrDocument.Save(string fileName, DocumentFormat format, OcrProgressCallback callback).

Each IOcrPage object in the Pages collection of this IOcrDocument object holds its recognition data internally. This data is used by this method to generate the final output document.

Typical OCR operation using the IOcrEngine involves starting up the engine then creating a new IOcrDocument object using the IOcrDocumentManager.CreateDocument method before dding the pages into it and perform either automatic or manual zoning. Once this is done, you can use the IOcrPage.Recognize method of each page to collect the recognition data and store it internally in the page. After the recognition data is collected, you use the various IOcrDocument.Save methods to save the document to its final format as well as the IOcrDocument.SaveXml method to save as XML.

You can also use the IOcrPage.RecognizeText method to recognize and return the recognition data as a simple String object.

You can use IOcrDocument.Save as many times as required to save the document to multiple formats. You can also continue to add and recognize pages (through the IOcrPage.Recognize method after you save the document.

To get the low level recognition data including the recognized characters and their confidence, use IOcrPage.GetRecognizedCharacters instead.

The IOcrDocument interface implements IDisposable, hence you must dispose the IOcrDocument object as soon as you are finished using it. Disposing an IOcrDocument object will free all the pages stored inside its IOcrDocument.Pages collection.

You can use the OcrProgressCallback to show the operation progress or to abort it. For more information and an example, refer to OcrProgressCallback.

Requirements

Target Platforms: Microsoft .NET Framework 3.0, Windows XP, Windows Server 2003 family, Windows Server 2008 family

See Also

Save(Stream,OcrDocumentFormat,OcrProgressCallback) requires an OCR module license and unlock key. For more information, refer to: Imaging Pro/Document/Medical Features