跳转到主要内容
此方法在客户端实现。ABBYY FineReader Engine 会在调用 FRDocument 对象的某些方法时调用此方法。它会向客户端传递处理过程中产生的提示和警告。
在 Windows 中,此方法还可以处理系统消息,以帮助避免应用程序在长时间操作期间看起来无响应。这对于带有用户界面的应用程序尤其有用。

语法

C++

HRESULT OnWarning(
  IFRDocument*  Sender,
  int           PageIndex,
  BSTR          Warning,
  VARIANT_BOOL* Cancel
);

C#

void OnWarning(
  IFRDocument Sender,
  int        PageIndex,
  string     Warning,
  ref bool   Cancel
);

Visual Basic .NET

Sub OnWarning( _
  Sender As IFRDocument,  _
  PageIndex As Integer, _
  Warning As String, _
  ByRef Cancel As Boolean _
)

参数

Sender [in] 指发送通知的 FRDocument 对象。 PageIndex [in] 此参数包含提示或警告所对应页面的索引。该消息不仅可以针对某一页面,也可以针对整个文档。在这种情况下,参数值为 -1。 Warning [in] 包含提示或警告信息。 Cancel [in, out] 您可以将此变量设置为 TRUE,表示应终止该操作。在这种情况下,报告该提示的分析或识别函数将返回 E_ABORT。

返回值

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

备注

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

另请参见

IFRDocumentEvents FRDocument