Introduction
引导浏览
API Reference
Visual Components Reference
Licensing
Distribution
Specifications
Frequently Asked Questions
Contact ABBYY
- How to Buy
- Technical Support

Chinese Simplified (简体中文)

English (English)

创建具有图形用户界面的应用程序

在创建带有用户界面的应用程式时，您可以使用 ABBYY FineReader Engine 可视化组件。可视化组件可为您提供现成的块来构建您自己的 OCR 应用程序用户界面。

您可以向应用程序用户共享处理文档，允许用户验证识别结果并编辑已识别文本。可视化组件可在所有处理场景中使用：预览处理图像可以显示在图像预处理场景中显示，文本编辑在文档转换场景中提供，而校验在字段别识别场景中特别有用。

让我们从用户界面角度看一下简单的 OCR 应用程序。单个文档的处理步骤：

打开图像

您可以向用户出示打开的图像，并且允许用户浏览处理文档的页面。

识别

要从文档中提取文本数据，需要先对文档进行识别。您可以向用户共享识别的文本，并授权用户编辑文本。

验证

可能需要对识别的文本进行验证。您可以向用户共享源图像和识别的文本，以便他们对两者进行对比。

导出

识别的文档可以保存到合适的存储格式或在外部应用程序中打开。

以下是 ABBYY FineReader Engine 可视化组件使用方法的详细说明。

重要事项！可视化组件要求 Microsoft Windows Common Controls 版本为6.0 或更高。

第1步添加可视化组件到应用程序表单

Visual Studio 可让您将 ActiveX 控件插入到对话框中。您可将可视化组件添加到 Toolbox 窗口（Toolbox 可从 View 菜单中获得）进行使用：

在 Tools 菜单中，单击选择 Toolbox 项（或添加/移除 Toolbox 项）。
在打开的对话框中，单击 COM Components 选项卡，然后选择 ABBYY DocumentViewer、ABBYY ImageViewer、ABBYY ZoomViewer、ABBYY TextEditor 和 ABBYY TextValidator 组件。
单击确定。所选项的图标现在 Toolbox 中可用。您可以将每个可视组件图标拖放到设计视图表面上。该操作也将添加基本代码，以便在激活的项目文件中创建可视化组件实例。
将可视化组件添加到表单后，您可以指定其在 Visual Studio 中可用的属性。例如，每个组件的 SettingsPath 属性应在设计时予以指定。

注：

在把可视化组件添加到 Visual Studio 2010 项目的过程中，您可能会收到错误消息。请参见在不同版本的 Visual Studio 中使用可视化组件。
Visual Studio 设计程序不支持 64 位的 ActiveX 控件。因此，不能将 64 位可视化组件添加到 Windows Form 应用程序。这是一种已知行为，Microsoft ActiveX 控件也有类似问题，例如， http://support.microsoft.com/kb/980533/en-us。为了提供对该问题的变通解决方法，FineReader Engine 同时安装了 32 位和 64 位的可视化组件，以便您选择在 64 位系统上安装可视化组件开发人员版本。在此情况下，您可在 Visual Studio 中使用 32 位版本的组件。使用可视化组件的 64 位应用程序不需要安装 32 位的可视化组件。

第2步同步可视化组件

组件同步器组件可让您同步应用程序中的可视化组件。这意味着所有查看和编辑操作将在所有连接的组件中同步处理。同步可视化组件：

在表单加载时，创建一个新的 ComponentSynchronizer 对象。
使用 ComponentSynchronizer 对象的 DocumentViewer、ImageViewer、ZoomViewer、TextEditor 和 TextValidator 属性将组件连接到同步器。

当组件通过 API 被连接到同步器时，组件同步器将如组件同步器的工作原理中所述开始工作。

C#

private void VisualComponentsForm_Load(object sender, System.EventArgs e)
{
// 附加组件到同步器
 Synchronizer = new FineReaderVisualComponents.ComponentSynchronizerClass();
 Synchronizer.DocumentViewer = ( FineReaderVisualComponents.DocumentViewer ) documentViewer.GetOcx();
 Synchronizer.ImageViewer = ( FineReaderVisualComponents.ImageViewer ) imageViewer.GetOcx();
 Synchronizer.ZoomViewer = ( FineReaderVisualComponents.ZoomViewer ) zoomViewer.GetOcx();
 Synchronizer.TextEditor = ( FineReaderVisualComponents.TextEditor ) textEditor.GetOcx();
}

第3步加载 ABBYY FineReader Engine

开始使用 ABBYY FineReader Engine，您需要先创建 Engine 对象。若要创建 Engine 对象，您可以使用 InitializeEngine 导出函数。也请参见加载 Engine 对象的其它方式。您可以在图像加载或者表单初始化期间加载 Engine 对象。

C#

[DllImport( "FREngine.dll", CharSet=CharSet.Unicode ), PreserveSig]
private static extern int InitializeEngine(
 String customerProjectID,
 String licensePath,
 String licensePassword,
 String FREngineDataFolder,
 String FREngineTempFolder,
 Bool lsSharedCPUCoresMode,
 ref FREngine.IEngine engine );
private void loadEngine()
{
int hresult = InitializeEngine( "<CustomerProjectID>",
 "<licensePath>",
 "<licensePassword>",
 "<FREngineDataFolder>",
 "<FREngineTempFolder>",
 false,
 ref Engine );
 Marshal.ThrowExceptionForHR( hresult );
}

第4步打开图像

如需显示可视化组件中的图像，首先应该打开图像。您可以执行以下过程来打开图像：

若要加载单个文档的图像，您应该创建 FRDocument 对象然后向其添加图像。您可以执行以下操作之一：

通过 Engine 对象的 CreateFRDocumentFromImage 方法创建 FRDocument 对象。该方法将创建 FRDocument 对象，并从指定文件加载图像。
借助 Engine 对象的 CreateFRDocument 方法创建 FRDocument 对象，然后从文件添加图像到创建的 FRDocument 对象（使用 FRDocument 对象的 AddImageFile、AddImageFileWithPassword 或 AddImageFileWithPasswordCallback 方法）。

通过 ComponentSynchronizer 对象的 Document 属性将文档附加到组件同步器。

该过程可以处理打开图像按钮的“鼠标单击”事件。

C#

private void openImage( string imageFileName )
{
// 加载 ABBYY FineReader Engine
if( Engine == null )
 {
  loadEngine();
  Engine.ParentWindow = this.Handle.ToInt32();
  Engine.ApplicationTitle = this.Text;
 }
// 打开图像
 Document = Engine.CreateFRDocumentFromImage( imageFileName, null );
// 使用同步器附加图像到可视化组件
 Synchronizer.Document = Document;
}

第5步识别文档

可以通过组件中可用的命令或使用 FineReader Engine API 调用可视化组件中识别图像（例如，请参见 FRDocument 对象的 Process 方法）。

您可以执行以下识别程序：

使用 FRDocument 对象识别文档。
文档已被更改，但并未借助可视化组件 GUI，因此需要将更改报告给可视化组件。对文档中的每个页面使用 FRPage 对象的 Update 方法。

该过程可以处理调用识别按钮的“鼠标单击”事件。

C#

private void recognizeDocument()
{
// 识别并同步整个文档 
 Document.Process( Synchronizer.ProcessingParams );
// 将更改报告给可视化组件
for( int i = 0; i < Document.Pages.Count; i++ )
 {
  Document.Pages[i].Update();
 }
}

第6步校验识别结果

可以使用“文本验证器”组件进行验证识别的数据。组件提供的用户界面可让您检查字符是否已被正确识别，并在必要时进行更正。

您可以执行以以下验证程序：

添加“文本验证器”组件到当前表单，或者为它创建一个新表单。
将“文本验证器”组件连接到组件同步器。使用 ComponentSynchronizer 对象的 TextValidator 属性。
使用 TextValidator 对象的 Spell 方法启动校验进程。

C#

private void validateButton_Click(object sender, System.EventArgs e)
{
if( validatorForm == null )
 {
  // 新建验证表单
  validatorForm = new ValidatorForm();
  validatorForm.Owner = this;
  // 添加验证器到同步器 
  Synchronizer.TextValidator = ( FineReaderVisualComponents.TextValidator ) validatorForm.TextValidator.GetOcx();
  validatorForm.Show();
  // 验证附件中的识别文本 
  validatorForm.TextValidator.Spell( null );
 }
}

第7步导出结果

识别的文档可以使用 DocumentViewer 中可用的命令或者 FineReader Engine API 进行保存。

例如，使用 FRDocument 对象的 Export 方法，做法是将 FileExportFormatEnum 常数分派为一个参数。处理完 FRDocument 对象后，释放该对象使用过的所有资源。使用 IFRDocument::Close 方法。该过程可以处理调用导出按钮的“鼠标单击”事件。

C#

// 将识别文档保存为 RTF 格式
Document.Export( "<文件名>"，FREngine.FileExportFormatEnum.FEF_RTF，null );
// 释放 FRDocument 对象
Document.Close()；

第8步卸载 ABBYY FineReader Engine

处理完 ABBYY FineReader Engine 后，您需要卸载 Engine 对象。为此，请使用 DeinitializeEngine 导出功能。

注：我们建议您在取消初始化 Engine 之前释放组件同步器。

该过程可以处理关闭应用程序窗口按钮的“鼠标单击”事件。

C#

[DllImport( "FREngine.dll", CharSet=CharSet.Unicode ), PreserveSig]
private static extern int DeinitializeEngine();
private void unloadEngine()
{
 if( Engine != null )
 {// 如果 Engine 已加载，请卸载
  Engine = null;
  int hresult = DeinitializeEngine();
  Marshal.ThrowExceptionForHR( hresult );
 }
}

您可以在 VisualComponents 示例中找到所述过程的示例实现。

另请参阅

自定义可视化组件的上下文菜单和工具栏

在不同版本的 Visual Studio 中使用可视化组件

24.03.2023 8:51:52

Your use of this site is conditioned on Your continued compliance with the Terms of Use.

Terms of Use

Disclaimer of Warranty

Limitation of Liability

Transmission and Submission of Information

Downloads

Use of Content

Trademarks

Links to Third-Party Sites

Foreign Legislation

Subscription Terms

Partner Subscription Terms