跳轉到主要內容
這個方法是在用戶端實作。ABBYY FineReader Engine 會針對 FRPage 物件的某些方法呼叫它。它會向客戶端提供目前作業 (分析、識別和匯出) 的大致完成百分比資訊。實作時可顯示進度指示器,如同 ABBYY FineReader 的作法。
在 Windows 中,它也可處理系統訊息,以協助避免應用程式在長時間作業期間看起來沒有回應。這對具有使用者介面的應用程式特別有幫助。

語法

C++

HRESULT OnProgress(
  IFRPage*      Sender,
  int           Percentage,
  VARIANT_BOOL* Cancel
);

C#

void OnProgress(
  IFRPage   Sender,
  int      Percentage,
  ref bool Cancel
);

Visual Basic .NET

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++] 如果這個 方法 回傳的值不是 S_OK,則表示用戶端發生錯誤;在此情況下,Cancel 參數的值將不予考量。

備註

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

另請參見

IFRPageEvents FRPage