跳轉到主要內容
此方法是在用戶端實作。ABBYY FineReader Engine 會在變更 Image Viewer 中的作用中頁面之前呼叫此方法。只有當頁面是透過 Image Viewer 的圖形使用者介面或任何同步元件變更時,才會觸發此程序。若作用中頁面是透過 Image Viewer 的 API 變更,或該作用中頁面已遭刪除,則不會觸發此程序。 此方法會將新作用中頁面的參考傳遞給用戶端。您也可以利用此方法取消該作業。

語法

C++

HRESULT OnActivePageChanging(
  IFRPage*      Page,
  VARIANT_BOOL* Cancel
);

C#

void OnActivePageChanging(
  IFRPage   Page,
  out bool Cancel
);

Visual Basic .NET

Sub OnActivePageChanging( _
  Page As IFRPage, _
  ByRef Cancel As Boolean _
)

參數

Page [in] 指向包含新作用中頁面的 FRPage 物件。此參數可為 NULL,表示文件中沒有作用中的頁面 (例如,所有頁面都已刪除時) 。 Cancel [out] 您可以將此變數設為 TRUE,表示應終止此程序。在此情況下,作用中的頁面不會變更。

回傳值

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

備註

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

另請參見

IImageViewerEvents