跳轉到主要內容
此方法於用戶端實作。ABBYY FineReader Engine 會針對 FRDocument 物件的某些方法呼叫此方法。它會將處理期間發生的提示和警告傳送給客戶端。
此外,在 Windows 中,它也可以處理任何系統訊息,以協助避免應用程式在長時間作業期間看起來失去回應。這對具有使用者介面的應用程式特別有幫助。

語法

C++

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

C#

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

Visual Basic .NET

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

參數

Sender [in] 指傳送通知的 FRDocument 物件。 PageIndex [in] 此參數包含提示或警告所對應頁面的索引。訊息不僅可對應到單一頁面,也可對應到整份文件。在此情況下,參數值為 -1。 Warning [in] 包含提示或警告內容。 Cancel [in, out] 您可將此變數設為 TRUE,表示應終止處理。在此情況下,發出提示的分析或識別函式會回傳 E_ABORT。

回傳值

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

備註

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

另請參見

IFRDocumentEvents FRDocument