跳轉到主要內容
此物件可透過 ABBYY FineReader Engine 的匯出函式，調整將辨識後文字匯出為 PDF (PDF/A) 格式時所使用的參數。此物件的指標會作為輸入參數傳遞至匯出方法，因此會影響匯出結果。新建立的此類型物件，其所有屬性都會設為合理的預設值。 我們建議您依照下列順序調整參數：
  1. 先設定 Scenario 屬性。此屬性會針對某些參數最佳化匯出，例如品質、檔案大小及／或匯出速度。當您選取此屬性的值時，PDFExportParams 物件及其子物件的屬性都會設為適合所選工作的值。
屬性設定可能會因輸入資料而有所不同。
  1. 接著，您可以自訂其他參數，使其更符合您的工作需求。詳情請參閱 調整匯出參數。
PDFExportParams 物件的屬性優先於其子物件的屬性。這表示，如果您變更 PDFExportParams 物件中某個屬性的值，其子物件的屬性值可能會自動遭到覆寫。反之，如果您變更某個子物件的屬性值，PDFExportParams 物件的屬性值則不會改變。
PDFExportParams 物件是持久性物件。這表示可將物件的目前狀態寫入持久性儲存體。之後，可藉由從持久性儲存體讀取物件狀態來重新建立該物件。以下方法可用於保存物件的持久狀態： Linux: SaveToFile 和 LoadFromFile Windows SaveToFile、LoadFromFile、SaveToMemory 和 LoadFromMemory。

​
屬性

,read-only

傳回 Engine 物件。

指定匯出至 PDF (PDF/A) 格式的情境，可針對下列參數最佳化匯出：品質、檔案大小及/或匯出速度。

若您變更此屬性的值，FontEmbeddingMode,TextAndBackgroundColorMode,WriteXmpMetadata,WriteTaggedPDFPDFExportFeatures 子物件的屬性，以及ColorPictureFormats,GrayPictureFormats,BwPictureFormatsPDFPictureCompressionParams 子物件的屬性將重設為預設值。

預設值為 PES_Balanced。

請注意，視所選情境而定，部分內部匯出設定可能會變更，進而影響下列 PDFExportParams 屬性的值：

指定匯出格式：PDF、PDF/A-1a、PDF/A-1b、PDF/A-2a、PDF/A-2b、PDF/A-2u、PDF/A-3a、PDF/A-3b 或 PDF/A-3u。

此屬性的值會影響匯出時可使用的設定。若此屬性的值不為 PCM_None (即執行匯出至 PDF/A 格式時) ：

  • PDFEncryptionInfo 子物件的屬性無法設為 TRUE
  • PDFExportFeatures 子物件的屬性只能設定為 PVN_Auto 或 PVN_Version14 (適用於 PDF/A-1a、PDF/A-1b)
  • 若格式為 PDF/A-1a、PDF/A-2a 或 PDF/A-3a，則PDFExportFeatures 子物件的屬性不能設定為 TSPV_No (檔案將一律帶有標籤)
  • PDFExportFeatures 子物件的屬性不能設定為 TSPV_No
  • PDFExportFeatures 子物件的屬性不能設定為 FEM_DontEmbed
  • PDFPictureCompressionParams 子物件的屬性不能設定為 CPF_J2K (僅適用於 PDF/A-1a、PDF/A-1b) 或 CPF_LZW
  • PDFPictureCompressionParams 子物件的屬性不能設定為 GPF_J2K (僅適用於 PDF/A-1a、PDF/A-1b) 或 GPF_LZW
  • PDFExportFeatures 子物件的屬性不能針對 PDF/A-1a、PDF/A-1b、PDF/A-2a、PDF/A-2b、PDF/A-2u 設定為 TRUE。

若不符合上述要求，將傳回錯誤。

預設值為 PCM_None，表示將執行匯出至 PDF 的操作。

指定將已辨識文字匯出為 PDF (PDF/A) 格式的模式。可選項目包括：僅文字與圖片、文字疊加於頁面影像上方、文字置於頁面影像下方、僅頁面影像、僅文字。

若此屬性設定為 PEM_TextOnly，則PDFPictureCompressionParams子物件的 BwPictureFormats、ColorPictureFormats 及 GrayPictureFormats 屬性值將被忽略。

此屬性的預設值為 PEM_ImageOnText。

指定在輸出 PDF (PDF/A) 檔案中使用的模式。

匯出為黑白 PDF 時，此屬性的值將被忽略。

此屬性的預設值為 MRC_Auto。

,read-only

指定其他匯出參數：加密資訊、PDF 版本等。

可讓您保留輸出 PDF (PDF/A) 檔案的色彩，或將其儲存為灰階或黑白格式。若不需要保留彩色文件的色彩，且希望縮減輸出檔案的大小，可將此屬性設定為 PCM_ForceToGray。

若 CorrectColorDepth 屬性設定為 TRUE，ABBYY FineReader Engine 可額外修正文件的色彩深度。例如，若將 Colority 設定為 PCM_ForceToGray 且 CorrectColorDepth 為 TRUE，FineReader Engine 將把彩色影像轉換為灰階，再偵測灰階影像的色彩深度，並在必要時將部分影像轉換為黑白。

此屬性的預設值為 PCM_KeepColority。

將此屬性設為 TRUE 可讓 ABBYY FineReader Engine 自動修正文件的色彩深度。若將屬性設為 FALSE，ABBYY FineReader Engine 將依照 Colority 屬性中定義的設定儲存文件色彩。

此屬性的預設值為 TRUE。

傳回附加至輸出 PDF 檔案的使用者自訂圖片集合。若要將圖片新增至此集合，請使用物件的方法，並透過物件的方法設定圖片在頁面上的位置。

,唯讀

指定將圖片寫入 PDF (PDF/A) 檔案的參數，包括 MRC 參數。這些參數可讓您覆寫所選匯出方案中定義的參數。

指定圖片解析度 (單位：dpi) 。ResolutionType 屬性指定此屬性值的解讀方式。

指定的解析度不得高於原始解析度。

此屬性的預設值為 300 dpi。

定義如何使用 Resolution 屬性中指定的圖片解析度值。此值可用於：

  • 作為絕對解析度 (套用至所有圖片) ，
  • 作為目標解析度 (僅在原始解析度高於目標解析度時適用，程式將選取最接近目標解析度的最佳 dpi 值) ，
  • 或忽略此值 (使用原始解析度) 。

此屬性的預設值為 PRT_Desired。

​
方法

名稱說明
CopyFrom以另一個物件中對應屬性的值初始化目前物件的屬性。
LoadFromFile從磁碟上的檔案還原物件內容。
LoadFromMemory <Note>：僅限 Windows。</Note>從全域記憶體還原物件內容。
SaveToFile將物件內容儲存至磁碟上的檔案。
SaveToMemory <Note>：僅限 Windows。</Note>將物件內容儲存至全域記憶體。
PDFExportParams 物件圖

​
輸出參數

此物件為 Engine 物件的 CreatePDFExportParams 方法之輸出參數。

​
輸入參數

此物件會作為下列方法的輸入參數傳遞：

​
範例

FREngine.IEngine engine;
FREngine.IFRDocument frDocument;
// 假設該文件已完成辨識與合成
// 設定匯出參數
FREngine.IPDFExportParams pdfParams = Engine.CreatePDFExportParams();
pdfParams.Scenario = FREngine.PDFExportScenarioEnum.PES_Balanced;
// 使用指定參數儲存結果
frDocument.Export( "D:\\Demo.pdf", FREngine.FileExportFormatEnum.FEF_PDF, pdfParams );
此物件會在下列程式碼範例中使用：

​
另請參閱

調整匯出參數 設定檔的使用 屬性的使用 符合 ZUGFeRD 標準的電子發票