跳转到主要内容
此方法在客户端实现。ABBYY FineReader Engine 在分析或识别 Image Viewer 中当前活动页面时会调用此方法。可通过以下任一方式启动该过程: 要了解如何调用这些命令,请参阅 Image Viewer Commands 列表。 要了解如何调用这些命令,请参阅 Zoom Viewer Commands 列表。 要了解如何调用这些命令,请参阅 Document Viewer Commands 列表。
  • 通过 FineReader Engine API
此方法会向客户端返回操作的大致完成百分比。其实现可以显示进度指示器,也可以处理系统消息,以帮助避免应用程序在长时间操作期间看起来无响应。这对于带用户界面的应用程序尤其有用。借助此方法,还可以取消操作。

语法

C++

HRESULT OnProgress(
  int           Percentage,
  VARIANT_BOOL* Cancel
);

C#

void OnProgress(
  int      Percentage,
  out bool Cancel
);

Visual Basic .NET

Sub OnProgress( _
  Percentage As Integer, _
  ByRef Cancel As Boolean _
)

参数

百分比 [in] 表示当前已完成工作的百分比。其取值范围为 0 到 100。 取消 [out] 您可以将此变量设置为 TRUE,以指示应终止该进程。在这种情况下,分析或识别进程将被中止。

返回值

[仅 C++] 如果此 方法 返回的值不是 S_OK,则表示客户端发生了错误;在这种情况下,将不考虑 Cancel Parameter 的值。

备注

此 方法 的客户端实现必须确保捕获并处理该 方法 内部抛出的所有异常,且不得让任何异常传播到该 方法 外部。异常一旦传播到 方法 外部,可能会导致不可预测的结果 (例如程序终止) 。

另请参见

ImageViewer IImageViewerEvents