跳转到主要内容
此方法在客户端实现。在 Image Viewer 中更改当前活动页面之前,ABBYY FineReader Engine 会调用该方法。如果页面是通过 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