跳轉到主要內容
此方法是在用戶端實作。ABBYY FineReader Engine 會在 Document Viewer 變更作用中頁面之前呼叫此方法。若頁面是透過 Document Viewer 的圖形使用者介面或任何同步元件變更,便會觸發此程序。若作用中頁面是透過 Document 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 參數的值將不予考量。

備註

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

另請參閱

IDocumentViewerEvents