Region 物件（IRegion 介面）

這是一個輔助物件，用於儲存 ABBYY FineReader Engine Block 區域的相關資訊。區域會以一組Rectangle表示：

各Rectangle之間不相交也不重疊
依由左至右或由上至下的順序加入

以下顯示一些 ABBYY FineReader Engine 區域的範例：

您可以呼叫 IEngine::CreateRegion 方法建立空白的 Region 物件，然後逐一呼叫 IRegion::AddRect 方法，將Rectangle加入其中。我們建議您依由上至下 (或由左至右) 的順序加入Rectangle，因為 Region 物件已針對這種方式最佳化，而且這也是加入Rectangle最快的方法。 Region 物件是持久性物件。這表示物件目前的狀態可以寫入持久性儲存體。之後，可藉由從持久性儲存體讀取物件狀態來重新建立該物件。下列方法可讓物件具備持久性： Linux：SaveToFile 和 LoadFromFile Windows：SaveToFile、LoadFromFile、SaveToMemory 和 LoadFromMemory。

屬性

名稱	型別	描述
Application	Engine, 唯讀的	回傳 Engine 物件。
Bottom	int, 唯讀的	回傳指定Rectangle下邊界的座標。
BoundingRectangle	FRRectangle, 唯讀的	回傳包含整個區域的最小Rectangle。
Count	int, 唯讀的	儲存區域中的Rectangle數量。
IsEmpty	VARIANT_BOOL, 唯讀的	指定區域是否為空。
Left	int, 唯讀的	回傳指定Rectangle左邊界的座標。
Right	int, 唯讀的	回傳指定Rectangle右邊界的座標。
Top	int, 唯讀的	回傳指定Rectangle上邊界的座標。

方法

名稱	描述
AddRect	將一個區域新增至區域。
AddRegion	將新的區域新增至現有區域。
CopyFrom	使用另一個物件中對應屬性的值，初始化目前物件的屬性。
CutRect	從區域中剪下矩形區域。
HasIntersectionWithRect	計算區域是否與指定的 Rectangle 相交。
HasIntersectionWithRegion	計算區域是否與指定的 Region 相交。
IsEqual	計算區域是否與指定的 Region 相同。
IsPointInRegion	計算指定的點是否位於區域內。
IsRectInRegion	計算指定的 Rectangle 是否包含在區域內。
IsRegionInRegion	計算指定的 Region 是否包含在區域內。
LoadFromFile	從磁碟上的檔案還原物件內容。
LoadFromMemory <Note> 僅限 Windows。 </Note>	從全域記憶體還原物件內容。
MakeEmpty	移除區域中的所有Rectangle。
SaveToFile	將物件內容儲存至磁碟上的檔案。
SaveToMemory <Note> 僅限 Windows。 </Note>	將物件內容儲存至全域記憶體。

物件圖

輸出參數

這個物件是 Engine 物件之 CreateRegion 方法的輸出參數。

輸入參數

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

FRPage 物件的 AnalyzeRegion、SynthesizeBusinessCard、SynthesizeBusinessCardEx 方法
ImageDocument 物件的 RemoveColorObjects、RemoveMotionBlur、RemoveGarbage、SmoothImage、SaveImageRegionTo 方法
CheckmarkGroup 物件的 AddNew 方法
SeparatorGroup 物件的 AddNew 方法
RegionsCollection 物件的 Add、InsertAt 方法
TrainingImage 物件的 SetImageData 方法
ImageModification 物件的 AddClipRegion、AddInvertRegion、AddPaintRegion、AddReplaceBlackPixelsRegion、AddReplaceWhitePixelsRegion 方法
對於 Windows Visual Components：
- IImageViewerEvents 介面的 OnAnalyzeRegion、OnToolChangeBlockRegion 方法
- IZoomViewerEvents 介面的 OnAnalyzeRegion、OnToolChangeBlockRegion 方法

範例

此物件用於名片辨識 (macOS) 程式碼範例。

另請參閱

使用屬性

總覽

函數

Engine 物件（IEngine 介面）

Engine 載入器

影像相關物件

Layout 相關物件

語言相關物件

文字相關物件

文件相關物件

批次處理器

機制相關物件

Parameter 物件

分類相關物件

授權相關物件

文件比較相關物件

補充物件與方法

列舉

Region 物件（IRegion 介面）

屬性

方法

輸出參數

輸入參數

範例

另請參閱

總覽

函數

Engine 物件（IEngine 介面）

Engine 載入器

影像相關物件

Layout 相關物件

語言相關物件

文字相關物件

文件相關物件

批次處理器

機制相關物件

Parameter 物件

分類相關物件

授權相關物件

文件比較相關物件

補充物件與方法

列舉

​屬性

​方法

​相關物件

​輸出參數

​輸入參數

​範例

​另請參閱

屬性

方法

相關物件

輸出參數

輸入參數

範例

另請參閱