跳轉到主要內容
此方法是在用戶端實作。ABBYY FineReader Engine 會針對 引擎 物件的 InjectTextLayer 方法呼叫此方法。它會將處理期間發生的提示與警告傳送給用戶端。它也可處理任何系統訊息,協助避免應用程式在長時間作業期間看似失去回應。

語法

C++

HRESULT OnWarning(
  int           PageIndex,
  BSTR          Warning,
  VARIANT_BOOL* Cancel
);

C#

void OnWarning(
  int      PageIndex,
  string   Warning,
  ref bool Cancel
);

Visual Basic .NET

Sub OnWarning( _
  PageIndex As Integer, _
  Warning As String, _
  ByRef Cancel As Boolean _
)

參數

PageIndex [in] 此參數包含提示或警告所指向頁面的索引。訊息不僅可指向單一頁面,也可指向整份文件。在此情況下,參數值為 -1。 Warning [in] 包含提示或警告。 Cancel [in, out] 您可以將此變數設為 TRUE,表示應終止處理程序。在此情況下,回報提示的處理函式會傳回 E_ABORT。

傳回值

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

備註

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

另請參閱

IProcessingEvents IEngine::InjectTextLayer