IDocumentViewerEvents インターフェイスの OnExportPages メソッド

このメソッドはクライアント側で実装されます。Document Viewer から開始されたエクスポート処理が始まる前に、ABBYY FineReader Engine によって呼び出されます。次のいずれかのコマンドが呼び出されると、この処理が実行されます。

• MI_SaveAsCsv
• MI_SaveAsDocX
• MI_SaveAsEpub
• MI_SaveAsFb2
• MI_SaveAsHtm
• MI_SaveAsOdt
• MI_SaveAsPdf
• MI_SaveAsPdfA
• MI_SaveAsPptX
• MI_SaveAsRtf
• MI_SaveAsTxt
• MI_SaveAsXls
• MI_SaveAsXlsX

これらのコマンドは、コンテキストメニュー内の対応する項目、または IDocumentViewer::Commands の DoCommand メソッドを使用して呼び出すことができます。詳細については、Document Viewer Commands の一覧を参照してください。

このメソッドは、エクスポート処理に関する情報 (エクスポート先のファイル名と形式、エクスポートのParameter、エクスポート対象のページのインデックス) をクライアントに渡します。また、このメソッドを使用して処理をキャンセルすることもできます。

​

構文

​

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
)

​

Parameter

FileName

[in] ページの保存先ファイル名を指定します。

Format

[in] エクスポート形式を指定します。FileExportFormatEnum 定数の説明を参照してください。

PageIndices

[in] IntsCollection オブジェクトとしてエクスポートする、文書内のページのインデックスを指定します。

ExportParams

[in] エクスポートするファイル形式に対応する型のエクスポートParameter オブジェクトを参照します。たとえば、ページを RTF ファイルに保存する場合は、RTFExportParams オブジェクトを参照します。

Cancel

[out] 処理を中止するには、この変数を TRUE に設定します。この場合、ページはエクスポートされません。

​

戻り値

[C++ のみ] このメソッドが S_OK 以外の値を返した場合、クライアント側でエラーが発生したことを示します。この場合、Cancel Parameter の値は考慮されません。

​

注記

このメソッドのクライアント実装では、メソッド内でスローされるすべての例外を確実にキャッチして処理し、例外がメソッドの外部に伝播しないようにする必要があります。例外がメソッドの外部に伝播すると、予期しない結果 (プログラムの終了など) を招くおそれがあります。

​

関連項目

IDocumentViewerEvents