跳轉到主要內容
這個方法是在用戶端實作。ABBYY FineReader Engine 會在變更 Text Editor 中的作用中頁面之前呼叫此方法。當頁面是透過 Text Editor 或任何同步元件的圖形使用者介面變更時,才會觸發此程序。如果作用中頁面是透過 Text Editor 的 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 物件。此 Parameter 可為 NULL,表示文件中沒有作用中頁面 (例如,所有頁面都已刪除時) 。 Cancel [out] 您可以將此變數設為 TRUE,表示應終止此程序。在此情況下,作用中頁面將不會變更。

回傳值

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

備註

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

另請參閱

ITextEditorEvents