跳转到主要内容
此方法在客户端实现。ABBYY FineReader Engine 会在 Engine 对象的 InjectTextLayer 方法中调用它。它会将处理过程中出现的提示和警告传递给客户端。它还可以处理各种系统消息,帮助避免应用程序在长时间操作期间看起来无响应。

语法

C++

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

C#

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

Visual Basic .NET

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

Parameter

PageIndex [in] 此 Parameter 包含提示或警告所对应的页面索引。该消息不仅可以针对某一页,也可以针对整个文档。在这种情况下,Parameter 值为 -1。 Warning [in] 包含提示或警告信息。 Cancel [in, out] 您可以将此变量设置为 TRUE,以指示应终止该过程。在这种情况下,报告提示的处理函数将返回 E_ABORT。

返回值

[仅适用于 C++] 如果此 方法 返回的值不是 S_OK,则表示客户端发生了错误,此时不会考虑 Cancel Parameter 的值。

备注

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

另请参阅

IProcessingEvents IEngine::InjectTextLayer