這個方法是在用戶端實作。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++] 如果這個 方法 回傳的值不是 S_OK,則表示用戶端發生錯誤;在此情況下,Cancel 參數的值將不予考量。
此方法的客戶端實作必須確保,在方法內部拋出的所有例外狀況都會被攔截並處理,且不會傳遞到方法外部。若例外狀況傳遞到方法外部,可能導致不可預期的結果 (例如程式終止) 。
IFRPageEvents
FRPage