此方法在客户端实现。ABBYY FineReader Engine 在调用 FRPage 对象的某些方法时会调用它。它向客户端提供当前操作 (分析、识别和导出) 的大致完成百分比信息。其实现可以显示进度指示器,就像 ABBYY FineReader 中那样。
在 Windows 中,它还可以处理任何系统消息,以帮助防止应用程序在长时间操作期间显得无响应。这对于具有用户界面的应用程序很有帮助。
HRESULT OnProgress(
IFRPage* Sender,
int Percentage,
VARIANT_BOOL* Cancel
);
void OnProgress(
IFRPage Sender,
int Percentage,
ref bool Cancel
);
Sub OnProgress( _
Sender As IFRPage, _
Percentage As Integer, _
ByRef Cancel As Boolean _
)
Sender
[in] 此参数表示发送通知的 FRPage 对象。
Percentage
[in] 此参数包含当前已完成的工作百分比,范围为 0 到 100。
Cancel
[in, out] 您可以将此变量设置为 TRUE 以指示进程应终止。在此情况下,报告该百分比的处理函数将返回 E_ABORT。
[C++ only] 如果此方法返回的值不是 S_OK,则表示客户端发生了错误,此时 Cancel 参数的值将被忽略。
此方法的客户端实现必须确保方法内部抛出的所有异常都被捕获和处理,且无异常传播至方法外部。将异常传播至方法外部可能会导致不可预测的结果 (例如程序终止) 。
IFRPageEvents
FRPage