跳轉到主要內容
這個方法是在用戶端實作。ABBYY FineReader Engine 在分析或辨識 Document Viewer 中目前作用中的頁面時,會呼叫此方法。可透過下列其中一種方式啟動此程序: 如需了解如何呼叫這些命令,請參閱 Document Viewer Commands 清單。 如需了解如何呼叫這些命令,請參閱 Image Viewer Commands 清單。 如需了解如何呼叫這些命令,請參閱 Zoom 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 Parameter 的值將不予考量。

備註

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

另請參閱

DocumentViewer IDocumentViewerEvents