跳轉到主要內容
此方法是在用戶端實作。ABBYY FineReader Engine 會在分析或辨識 Image Viewer 中的作用中頁面時呼叫此方法。此程序可透過下列任一方式叫用： 如需瞭解如何呼叫這些命令，請參閱 Image Viewer Commands 清單。 如需瞭解如何呼叫這些命令，請參閱 Zoom Viewer Commands 清單。 如需瞭解如何呼叫這些命令，請參閱 Document Viewer Commands 清單。
  • 透過 FineReader Engine API
此方法會將作業的大致完成百分比傳回用戶端。其實作可顯示進度指示器，也可處理任何系統訊息，以協助避免應用程式在長時間作業期間看起來失去回應。這對具有使用者介面的應用程式特別實用。您也可以藉由此方法取消作業。

​
語法

​
C++

HRESULT OnProgress(
  int           Percentage,
  VARIANT_BOOL* Cancel
);

​
C#

void OnProgress(
  int      Percentage,
  out bool Cancel
);

​
Visual Basic .NET

Sub OnProgress( _
  Percentage As Integer, _
  ByRef Cancel As Boolean _
)

​
參數

百分比 [in] 包含目前已完成工作的百分比，範圍為 0 到 100。 取消 [out] 您可以將此變數設為 TRUE，表示應終止此程序。在此情況下，分析或辨識程序會中止。

​
回傳值

[僅限 C++] 如果此方法回傳的值不是 S_OK，則表示用戶端發生了錯誤；在這種情況下，Cancel Parameter 的值將不予考慮。

​
備註

此 method 的用戶端實作必須確保：在 method 內擲出的所有例外狀況都會被攔截並妥善處理，且不會有任何例外狀況傳播到 method 外。若例外狀況傳播到 method 外，可能會導致不可預期的結果 (例如程式終止) 。

​
另請參見

ImageViewer IImageViewerEvents