跳轉到主要內容
此方法會開啟指定的影像檔案，對其執行預先處理、版面分析、辨識、頁面與文件合成，並將辨識出的文字匯出為所選的輸出格式。RecognizeImageFile 方法可處理多頁影像，並將辨識結果匯出至單一檔案。

​
語法

​
C++

HRESULT RecognizeImageFile(
  BSTR                         ImageFileName,
  IPrepareImageMode            PrepareMode,
  IDocumentProcessingParams*   DocumentProcessingParams,
  FileExportFormatEnum         ExportFormat,
  IUnknown*                    ExportParams,
  IImagePasswordCallback*      PasswordCallback,
  BSTR                         OutputFileName
);

​
C#

void RecognizeImageFile(
  string                   ImageFileName,
  IPrepareImageMode         PrepareMode,
  IDocumentProcessingParams DocumentProcessingParams,
  FileExportFormatEnum     ExportFormat,
  object                   ExportParams,
  IImagePasswordCallback   PasswordCallback,
  string                   OutputFileName
);

​
Visual Basic .NET

Sub RecognizeImageFile( _
  ImageFileName As String, _
  PrepareMode As IPrepareImageMode, _
  DocumentProcessingParams As IDocumentProcessingParams, _
  ExportFormat As IFileExportFormatEnum, _
  ExportParams As Object, _
  PasswordCallback As IImagePasswordCallback, _
  OutputFileName As String _
)

​
參數

ImageFileName [in] 包含要識別之影像檔案的完整路徑。如果此檔案不是 ABBYY FineReader Engine 內部格式，則會使用 PrepareImageMode 屬性的預設值進行準備；或者，如果已載入 profile，則會使用此設定檔中設定的參數。 PrepareMode [in] 此變數參照 PrepareImageMode 物件，該物件會儲存將影像轉換為內部格式所需的參數。此參數可以為 0，在此情況下會使用影像準備模式的預設參數；或者，如果已載入 profile，則會使用此設定檔中設定的參數。 DocumentProcessingParams [in] 參照 DocumentProcessingParams 物件，該物件會儲存所有處理參數。此參數可以為 0。在此情況下，文件會使用預設參數進行處理 (所有處理參數都設為預設值，且識別語言為英文) ；或者，如果已載入 profile，則會使用此設定檔中設定的參數。 ExportFormat [in] 此 FileExportFormatEnum 類型的變數會指定匯出已識別文字的輸出檔案格式。 ExportParams [in] 透過此輸入參數傳遞與檔案格式相對應類型的匯出參數物件。例如，如果您要建立 RTF 檔案，請建立 RTFExportParams 物件，在其中設定必要參數，然後將其作為 exporterParams 輸入參數傳遞給此方法。此參數為選用，可以為 0；在此情況下，匯出參數會使用預設值；或者，如果已載入 profile，則會使用此設定檔中設定的參數。
在 Linux 中，如果您使用的是以 out-of-process 方式載入的 ABBYY FineReader Engine，則必須為此參數傳遞 NULL。
PasswordCallback [in] 參照使用者實作的 ImagePasswordCallback 類型物件介面，用於處理存取 PDF 格式影像時可能出現的密碼要求。此參數為選用，可以為 0；在此情況下，將無法處理受密碼保護的檔案。 OutputFileName [in] 包含應匯出已識別文字之輸出檔案的完整路徑。如果此位置已存在檔案，則會直接覆寫而不提示，或根據匯出模式將已識別文字附加至檔案末尾。

​
傳回值

如果使用者中斷辨識，此方法會傳回 E_ABORT。如果使用者中斷模式訓練，此方法會傳回 FREN_E_PATTERN_TRAINING_ABORTED。此方法也會傳回 ABBYY FineReader Engine 函式的標準傳回碼。

​
備註

對於 Linux 和 Windows：ABBYY FineReader Engine 可根據 IEngine::MultiProcessingParams 屬性的值，將多頁文件的處理工作分散到各個 CPU 核心。

​
另請參閱

Engine IImagePasswordCallback 使用設定檔