跳轉到主要內容
此方法會將指定的頁面以外部格式儲存成檔案。可用的檔案格式由 FileExportFormatEnum 列舉常數表示。
在 Linux 和 Windows 中,只有匯出為 PDF (TextOnly 模式除外) 或 PPTX 格式時,才支援平行處理。

語法

C++

HRESULT ExportPages(
  BSTR                 ExportFileName,
  FileExportFormatEnum Format,
  IUnknown*            ExportParams,
  IIntsCollection*     PageIndices,
  IStringsCollection** AdditionalFiles,
  IStringsCollection** AdditionalDirectories
);

C#

void ExportPages(
  string                ExportFileName,
  FileExportFormatEnum  Format,
  object                ExportParams,
  IIntsCollection        PageIndices,
  out IStringsCollection AdditionalFiles,
  out IStringsCollection AdditionalDirectories
);

Visual Basic .NET

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。若您想傳入匯出參數,請建立包含所需設定的使用者設定檔
PageIndices [in] 此參數參照 IntsCollection 物件,其中包含要匯出的頁面編號。頁面將依其在文件中的排列順序匯出。若您想變更頁面順序,應使用對應 FRPages 集合的 Renumber 方法對文件中的頁面重新編號。 AdditionalFiles [out] 指向 IStringsCollection* 指標變數的指標,該變數用於接收 StringsCollection 物件的介面指標。*AdditionalFiles 不應參照任何有效物件。StringsCollection 由此方法在內部建立。此物件包含匯出過程中所產生的所有附加檔案的完整路徑清單。 AdditionalDirectories [out] 指向 IStringsCollection* 指標變數的指標,該變數用於接收 StringsCollection 物件的介面指標。*AdditionalDirectories 不應參照任何有效物件。StringsCollection 由此方法在內部建立。此物件包含匯出過程中所產生的所有附加目錄的完整路徑清單。

回傳值

在匯出為 PDF 或 XPS 格式時,此方法可能會回傳 FREN_E_INVALID_CREATION_DATE_FORMAT 或 FREN_E_INVALID_MODIFICATION_DATE_FORMAT 錯誤,表示建立日期或修改日期的格式無效。它也會回傳 ABBYY FineReader Engine 函式的標準回傳碼

備註

  • 在大多數情況下,匯出文件頁面之前必須先執行文件合成。若省略此步驟,可能會在匯出時導致錯誤。詳情請參閱 IFRDocument::SynthesizePages 方法的說明。
  • 此方法可能會向附加至 FRDocument 物件之 IConnectionPointContainer 介面的接聽程式回報事件。
  • 在 Linux 和 Windows 上:ABBYY FineReader Engine 可根據 IEngine::MultiProcessingParams 屬性的值,將多頁文件的匯出作業分散至各個 CPU 核心。

另請參閱

FRDocument