FRPage 物件（IFRPage 介面）

屬性
方法
相關物件
輸出參數
輸入參數
相關的 Visual Components
範例
另請參閱

此物件對應到一個頁面。

在 Linux 和 Windows 中，這可以是文件中的一個頁面，或是由 Batch Processor 產生的頁面。

它提供一組用於頁面預處理、分析、識別、頁面合成及匯出的方法。此物件的方法不會執行文件合成 (Synthesize 方法除外) 。在匯出結果之前，您必須明確呼叫某個會執行文件合成的方法。如需詳細資訊，請參閱預處理、分析、識別與合成的調整參數。 FRPage 物件是所謂的「可連接物件」。對於 Windows 上 FRE 的 Visual Basic，可以使用 WithEvents 宣告它。對於 C++ (所有支援的作業系統) ，這表示它支援 IConnectionPointContainer 介面。若要在處理期間接收通知事件，C++ 使用者應建立一個衍生自 IFRPageEvents 介面的物件，並且…

在 Linux 和 macOS 中，透過呼叫 AdviseFREngineObject 全域函式，將其連接到 FRPage 物件。
在 Windows 中：以標準 COM 方式，在該物件與 FRPage 物件中實作的事件來源之間建立連線。

在 Windows 中：FRPage 物件的方法會透過特殊的傳出介面回報頁面處理進度資訊。這些介面為 IFRPageEvents (供 C++ 使用) 和 dispinterface DIFRPageEvents (供 Visual Basic 使用) 。請注意，Visual Basic 使用者無需在意事件介面的實作細節，因為此開發平台提供了簡便的處理方式。

屬性


	,唯讀的	回傳 Engine 物件。

	,唯讀的	回傳包含此頁面的文件。
	,唯讀的	可存取此頁面的影像。
		可存取此頁面的版面配置。當您將 Layout 物件指派給此屬性時 (例如將資料從一個頁面傳送到另一個頁面) ，對應文件的邏輯結構將會失效。您必須呼叫其中一個合成方法來還原文件結構。不過，您不需要對整份文件執行合成，只需合成已變更的頁面即可，例如使用 Synthesize 方法。
	,唯讀的	以特殊的「純文字」格式回傳此頁面的文字。
	, 唯讀的	指定此頁面來源影像的完整路徑。

	, 唯讀的	指定已識別頁面的主要語言。此屬性包含偵測到的語言集合中第一個語言的內部名稱 (DetectedLanguages 屬性) 。只有在啟用自動語言偵測的情況下執行識別時，此屬性值才有意義 (詳情請參閱 IRecognizerParams::LanguageDetectionMode 屬性) 。預設值為空字串。
	,唯讀的	可存取在已識別頁面上偵測到的識別語言集合。集合中的語言會依出現頻率排序：從最高到最低。只有在啟用自動語言偵測的情況下執行識別時，此屬性值才有意義 (詳情請參閱 IRecognizerParams::LanguageDetectionMode 屬性) 。語言清單只會在識別後更新；也就是說，如果您手動編輯頁面的版面配置，該集合仍會維持不變。

	, 唯讀的	指定頁面的邏輯結構是否已不是最新狀態。如果此屬性的值為 TRUE，則您應在匯出前先對該頁面執行文件合成；否則，匯出時將會發生錯誤。當您使用 Visual Components 時，此屬性相當實用。如果使用者透過 Visual Components 的 GUI 變更此頁面的版面配置，頁面的邏輯結構就會失效。若使用 Visual Components 中可用的命令匯出這類頁面，Visual Components 會自動合成頁面；但若您使用 FineReader Engine API 方法進行匯出，則必須由您負責在匯出前先對該頁面執行文件合成。
	, 唯讀的	回傳該頁面在來源檔案中的索引。
	, 唯讀的	指出此頁面的來源檔案是否為帶有數位簽章的 PDF。

	,唯讀的	可存取頁面上偵測到的名片集合。

		Visual Components 目前僅支援 Windows。指定是否允許使用 Undo 與 Redo 方法。如果此屬性的值為 TRUE，則所有透過可修改頁面的方法 (例如 FRPage 或物件的方法) 或從 Windows Visual Components 呼叫的命令，都可以加入復原堆疊。在此情況下，從 Visual Components 呼叫的命令會自動加入堆疊。若要將從 API 呼叫的命令加入堆疊，請使用 Update 方法。對於已在 Visual Components 中開啟的頁面，無法將此屬性設為 FALSE。
	, 唯讀的	Visual Components 目前僅支援 Windows。指定是否可對最近一次已復原的命令執行 Redo 方法；該命令可能是透過某個可修改頁面的方法 (例如 FRPage 或物件的方法) 呼叫，或是從某個 Visual Components 呼叫。
	, 唯讀的	Visual Components 目前僅支援 Windows。指定是否可對最近一次呼叫的命令執行 Undo 方法；該命令可能是透過某個可修改頁面的方法 (例如 FRPage 或物件的方法) 呼叫，或是從某個 Visual Components 呼叫。

方法

名稱	Description
AddWordsToCacheDictionary	此方法會將一組詞語加入快取字典。
AddWordToCacheDictionary	此方法會將一個單字加入快取字典。
Analyze	分析頁面。
AnalyzeRegion	分析指定區域內影像的版面結構。
AnalyzeTable	以表格區塊取代指定區塊，並分析表格結構。
CleanCacheDictionary	此方法會刪除快取字典中的所有字詞。
DetectOrientation	偵測頁面方向。
DetectResolution	從指定範圍中選取最佳解析度。
Export	將頁面儲存為外部格式檔案。
ExtractBarcodes	找出並辨識所有條碼區塊。
ExtractMrz	從機器可讀區域 (MRZ) 擷取資料。
FindPageSplitPosition	找出可分割影像的位置。
Flush	卸載與 FRPage 物件對應的 ImageDocument 和 Layout 物件；如果沒有任何對它們的參考，則在必要時將其儲存到磁碟。儲存到磁碟是可選的；如果資料未變更，您可以省略此步驟。
IsEmpty	檢查頁面是否為空白。
LearnCheckmarks	訓練 FineReader Engine 以識別自訂類型的核取記號。
PreprocessAnalyzeRecognize	對頁面執行預處理、版面分析、識別及頁面合成。
Preprocess	對頁面進行預處理：校正頁面方向、色彩反相及幾何變形。頁面預處理會在頁面分析之前執行。
Recognize	辨識頁面並執行頁面合成。
RecognizeBlocks	在明確指定的一組 Block 中進行文字辨識並執行頁面合成。
重做	<Warning> Visual Components 目前僅支援 Windows。</Warning> 重新執行最近一次透過 FineReader Engine API 呼叫後又被撤銷的命令。
合成	對單一頁面執行文件合成。在 Linux 和 Windows 上，使用 Batch Processor 處理單頁文件時，此方法可能很有幫助。
SynthesizeBusinessCard	嘗試在指定的已辨識區域中尋找名片欄位。
SynthesizeBusinessCardEx	嘗試使用合成參數，在指定的已辨識區域中尋找名片欄位。
復原	<Warning> Visual Components 目前僅支援 Windows。</Warning> 復原最近一次透過 FineReader Engine API 呼叫的命令。
Update	<Warning> Visual Components 目前僅支援 Windows。</Warning> 在 Linux 和 macOS 中：將頁面版面配置中的變更儲存到復原堆疊中。在 Windows 中：將透過 FineReader Engine API 對頁面版面配置所做的變更傳送至 Visual Components，並將這些變更儲存到復原堆疊中。<Note> 呼叫此方法時，對應文件的邏輯結構會失效。必須呼叫其中一種合成方法來還原文件結構。不過，您不需要對整個文件執行合成，只需對已變更的頁面進行合成即可，例如使用 Synthesize 方法。</Note>

物件圖

輸出參數

此物件是下列方法的輸出參數：

Item 方法 (FRPages 物件)
在 Linux 和 Windows 上：GetNextProcessedPage 方法 (BatchProcessor 物件)

輸入參數

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

IndexOf 方法，屬於 FRPages 物件
AddPage 方法，屬於 FRDocument 物件
AddPage 方法，屬於 ExportFileWriter 物件
CreateObjectFromPage 方法，屬於 ClassificationEngine 物件
OnProgress、OnWarning、OnRegionProcessed、OnPageProcessed 方法，屬於 IFRPageEvents 介面
PageRemoved 方法，屬於 IFRPagesEvents 介面
ComparePages 方法，屬於 Comparator 物件
在 Linux 和 Windows 上：ProcessPageAsync 方法，屬於 BatchProcessor 物件
在 Windows 中使用 Visual Components 時：
- OnActivePageChanged、OnActivePageChanging 方法，屬於 DocumentViewerEvents 介面
- OnActivePageChanged、OnActivePageChanging 方法，屬於 IImageViewerEvents 介面
- OnActivePageChanged 方法，屬於 IZoomViewerEvents 介面
- OnActivePageChanged、OnActivePageChanging 方法，屬於 ITextEditorEvents 介面
- OnActivePageChanged 方法，屬於 ITextValidatorEvents 介面

範例

C# 程式碼

FREngine.IEngine engine;
string fileName;
FREngine.IBatchProcessor batchProcessor;
// 假設 Batch Processor 已建立並啟動
// 取得已識別的頁面，並將其匯出為 PDF 格式
FREngine.IFRPage page = batchProcessor.GetNextProcessedPage();
while( page != null ) {
 // 在匯出前合成頁面
 page.Synthesize(null);
 // 將頁面匯出至檔案
 page.Export(fileName, FREngine.FileExportFormatEnum.FEF_PDF, null);
 page = batchProcessor.GetNextProcessedPage();
}

此物件用於下列程式碼範例：

macOS: 名片識別和 RecognizedTextProcessing
Linux: BCR、BatchProcessing、CustomLanguage、CommandLineInterface
Windows: BatchProcessing、CustomLanguage、CommandLineInterface、RecognizedTextProcessing、VisualComponents，以及示範工具：BatchProcessingRecognition、Engine 預先定義處理設定檔。

另請參閱

FRPages 使用可連接物件使用屬性

FRPages 物件的 Swap 方法

FRPage 物件的 AddWordsToCacheDictionary 方法

⌘I

總覽

函數

Engine 物件（IEngine 介面）

Engine 載入器

影像相關物件

Layout 相關物件

語言相關物件

文字相關物件

文件相關物件

批次處理器

機制相關物件

Parameter 物件

分類相關物件

授權相關物件

文件比較相關物件

補充物件與方法

列舉

FRPage 物件（IFRPage 介面）

屬性

方法

輸出參數

輸入參數

範例

另請參閱

總覽

函數

Engine 物件（IEngine 介面）

Engine 載入器

影像相關物件

Layout 相關物件

語言相關物件

文字相關物件

文件相關物件

批次處理器

機制相關物件

Parameter 物件

分類相關物件

授權相關物件

文件比較相關物件

補充物件與方法

列舉

​屬性

​方法

​相關物件

​輸出參數

​輸入參數

​相關的 Visual Components

​範例

​另請參閱

屬性

方法

相關物件

輸出參數

輸入參數

相關的 Visual Components

範例

另請參閱