このメソッドは、指定したページを外部形式のファイルとして保存します。使用可能なファイル形式は、列挙型 FileExportFormatEnum の定数で表されます。
Linux と Windows では、並列処理がサポートされるのは、PDF (TextOnly モードを除く) および PPTX 形式へのエクスポートのみです。
HRESULT ExportPages(
BSTR ExportFileName,
FileExportFormatEnum Format,
IUnknown* ExportParams,
IIntsCollection* PageIndices,
IStringsCollection** AdditionalFiles,
IStringsCollection** AdditionalDirectories
);
void ExportPages(
string ExportFileName,
FileExportFormatEnum Format,
object ExportParams,
IIntsCollection PageIndices,
out IStringsCollection AdditionalFiles,
out IStringsCollection AdditionalDirectories
);
Sub ExportPages( _
ExportFileName As String, _
Format As FileExportFormatEnum, _
ExportParams As Unknown, _
PageIndices As IIntsCollection, _
[ByRef AdditionalFiles As IStringsCollection = Nothing], _
[ByRef AdditionalDirectories As IStringsCollection = Nothing] _
)
ExportFileName
[in] この変数には、出力ファイルのフルパスが格納されます。指定したファイルがすでに存在する場合は、確認なしで上書きされます。
Format
[in] この変数は、出力ファイルの形式を指定します。サポートされているファイル形式については、FileExportFormatEnum の説明を参照してください。
ExportParams
[in] この入力パラメーターには、ファイル形式に対応する型のエクスポートパラメーターオブジェクトを渡します。たとえば、テキストを RTF ファイルに保存する場合は、RTFExportParams オブジェクトを作成し、必要なパラメーターを設定して、このメソッドの ExportParams 入力パラメーターとして渡します。このパラメーターには 0 を指定することもでき、その場合はエクスポートパラメーターの既定値が使用されます。
Linux で、ABBYY FineReader Engine をアウトプロセスでロードして使用している場合は、このパラメーターには NULL を渡す必要があります。エクスポートパラメーターを指定する場合は、必要な設定を含む user profile を作成してください。
PageIndices
[in] このパラメーターは、エクスポートするページ番号を含む IntsCollection オブジェクトを参照します。ページは、Document 内での配置順にエクスポートされます。ページの順序を変更する場合は、対応する FRPages コレクションの Renumber メソッドを使用して、Document 内のページ番号を振り直す必要があります。
AdditionalFiles
[out] StringsCollection オブジェクトのインターフェイス ポインターを受け取る IStringsCollection* ポインター変数へのポインターです。 *AdditionalFiles は有効なオブジェクトを参照していてはなりません。StringsCollection はこのメソッドによって内部的に作成されます。このオブジェクトには、エクスポート時に生成された追加ファイルのフルパスの一覧が含まれます。
AdditionalDirectories
[out] StringsCollection オブジェクトのインターフェイス ポインターを受け取る IStringsCollection* ポインター変数へのポインターです。 *AdditionalDirectories は有効なオブジェクトを参照していてはなりません。StringsCollection はこのメソッドによって内部的に作成されます。このオブジェクトには、エクスポート時に生成された追加ディレクトリのフルパスの一覧が含まれます。
PDF または XPS 形式へのエクスポート時に、このメソッドは FREN_E_INVALID_CREATION_DATE_FORMAT または FREN_E_INVALID_MODIFICATION_DATE_FORMAT エラーを返す場合があります。これらのエラーは、作成日または変更日の形式が無効であることを示します。また、このメソッドは ABBYY FineReader Engine 関数の標準戻りコード も返します。
- ほとんどの場合、Document のページをエクスポートする前に文書合成を実行する必要があります。文書合成を省略すると、エクスポート時にエラーが発生する可能性があります。詳しくは、IFRDocument::SynthesizePages メソッドの説明を参照してください。
- このメソッドは、FRDocument オブジェクトの IConnectionPointContainer インターフェイスに接続されたリスナーにイベントを通知することがあります。
- Linux と Windows では、IEngine::MultiProcessingParams プロパティの値に応じて、ABBYY FineReader Engine は複数ページのDocumentのエクスポートを CPU コアに分散して実行できます。
FRDocument