跳轉到主要內容
此方法在用戶端實作。在 Zoom Viewer 中對目前作用中的頁面進行分析或辨識時，ABBYY FineReader Engine 會呼叫此方法。此程序可透過下列其中一種方式叫用： 若要瞭解如何呼叫這些命令，請參閱 Zoom Viewer Commands 清單。 若要瞭解如何呼叫這些命令，請參閱 Image 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 _
)

​
參數

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

​
回傳值

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

​
備註

此方法的客戶端實作必須確保，在方法內部拋出的所有例外都會被捕捉並處理，且不會有任何例外傳遞到方法外部。例外若傳遞到方法外部，可能會導致無法預期的結果 (例如程式終止) 。

​
另請參見

ZoomViewer IZoomViewerEvents