跳转到主要内容
此方法在客户端实现。ABBYY FineReader Engine 会在从 Document Viewer 发起的导出过程开始前调用该方法。调用以下任一命令时,都会启动该过程: 这些命令既可通过上下文菜单中的相应菜单项调用,也可通过 IDocumentViewer::Commands 的 DoCommand 方法调用。详情请参阅 Document Viewer Commands 列表。 该方法会向客户端传递导出操作的相关信息:导出文件名和格式、导出参数,以及即将导出的页面索引。还可以借助此方法取消该操作。

语法

C++

HRESULT OnExportPages(
  BSTR                 FileName,
  FileExportFormatEnum Format,
  IIntsCollection*     PageIndices,
  IUnknown*            ExportParams,
  VARIANT_BOOL*        Cancel
);

C#

void OnExportPages(
  string               FileName,
  FileExportFormatEnum Format,
  IIntsCollection      PageIndices,
  object               ExportParams,
  out bool             Cancel
);

Visual Basic .NET

Sub OnActivePageChanging( _
  FileName As String, _
  Format As FileExportFormatEnum, _
  PageIndices As IIntsCollection, _
  ExportParams As Object, _
  ByRef Cancel As Boolean
)

参数

FileName [in] 包含用于保存页面的文件名。 Format [in] 指定导出格式。请参阅 FileExportFormatEnum 常量的说明。 PageIndices [in] 指定文档中应导出的页面索引,以 IntsCollection 对象形式提供。 ExportParams [in] 指与导出文件格式对应类型的导出参数对象。例如,如果页面保存为 RTF 文件,则指 RTFExportParams 对象。 Cancel [out] 您可以将此变量设置为 TRUE,表示应终止该过程。在这种情况下,页面不会被导出。

返回值

[仅适用于 C++] 如果此方法返回的值不是 S_OK,则表示客户端发生了错误,此时不会考虑 Cancel 参数的值。

备注

此方法的客户端实现必须确保:在方法内部抛出的所有异常都会被捕获并得到处理,且不会传播到方法外部。否则,异常一旦传播到方法外部,可能会导致不可预知的结果 (例如程序终止) 。

另请参见

IDocumentViewerEvents