跳轉到主要內容
這個方法是在用戶端實作。ABBYY FineReader Engine 會由 Engine 物件的 InjectTextLayer 方法呼叫它。它會向用戶端提供作業大約已完成多少百分比的資訊。其實作可以顯示進度指示器,如同 ABBYY FineReader 中的做法。它也可以處理任何系統訊息,協助避免應用程式在長時間作業期間看起來沒有回應。

語法

C++

HRESULT OnProgress(
  int           Percentage,
  VARIANT_BOOL* Cancel
);

C#

void OnProgress(
  int      Percentage,
  ref bool Cancel
);

Visual Basic .NET

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

參數

百分比 [in] 此參數包含目前工作已完成的百分比,範圍為 0 到 100。 取消 [in, out] 您可以將此變數設為 TRUE,表示應終止此程序。在此情況下,回報百分比的處理函式會傳回 E_ABORT。

返回值

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

備註

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

另請參見

IProcessingEvents IEngine::InjectTextLayer