跳转到主要内容
此方法在客户端实现。ABBYY FineReader Engine 会在页面识别过程开始前调用此方法,而该过程可通过以下任一方式从 Document Viewer 中启动:
  • 在上下文菜单中选择 Read Page 项
  • 按下 Ctrl+R 快捷键
  • 使用 IDocumentViewer::Commands 的 DoCommand 方法调用 MI_Read 命令
该方法用于通知客户端,所选页面即将开始识别。通过此方法也可以取消该操作。

语法

C++

HRESULT OnReadPages( VARIANT_BOOL* Cancel );

C#

void OnReadPages( out bool Cancel );

Visual Basic .NET

Sub OnReadPages(ByRef Cancel As Boolean)

Parameters

Cancel [out] 您可以将此变量设置为 TRUE,以指示应终止该流程。此时将不会执行识别。

返回值

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

备注

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

另请参阅

IDocumentViewerEvents