跳转到主要内容
此方法在客户端实现。当通过调用 Image Viewer 中的 MI_Read 命令启动页面识别时,ABBYY FineReader Engine 会在识别过程开始前调用此方法。有关此命令的调用方式,请参见 Image Viewer Commands 列表。 该方法用于通知客户端,当前活动页面即将被识别。借助此方法,可以取消该操作。

语法

C++

HRESULT OnReadPage( VARIANT_BOOL* Cancel );

C#

void OnReadPage( out bool Cancel );

Visual Basic .NET

Sub OnReadPage(ByRef Cancel As Boolean)

参数

Cancel [out] 您可以将此变量设置为 TRUE,表示应终止该进程。在这种情况下,将不会执行页面识别。

返回值

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

备注

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

另请参阅

IImageViewerEvents OnReadBlocks