Region 对象（IRegion 接口）

这是一个辅助对象，用于存储 ABBYY FineReader Engine 中 Block Region 的信息。一个Region表示为一组Rectangle：

这些Rectangle互不相交，也不重叠
按从左到右或从上到下的顺序添加

下面显示了 ABBYY FineReader Engine 中 Region 的一些示例：

可以通过调用 IEngine::CreateRegion 方法创建一个空的 Region 对象，然后通过逐个调用 IRegion::AddRect 方法向其中添加Rectangle。建议按从上到下 (或从左到右) 的顺序添加Rectangle，因为 Region 对象已针对这种方式进行优化，这也是向其中添加Rectangle的最快方法。 Region 对象是一个持久对象。这意味着可以将该对象的当前状态写入持久存储。之后，可以通过从持久存储中读取对象状态来重新创建该对象。以下方法可用于实现对象的持久化： Linux：SaveToFile 和 LoadFromFile Windows：SaveToFile、LoadFromFile、SaveToMemory 和 LoadFromMemory。

属性

名称	类型	说明
Application	Engine, 只读	返回 Engine 对象。
Bottom	int, 只读	返回指定矩形底边的坐标。
BoundingRectangle	FRRectangle, 只读	返回包含整个 Region 的最小矩形。
Count	int, 只读	表示 Region 中矩形的数量。
IsEmpty	VARIANT_BOOL, 只读	指示 Region 是否为空。
Left	int, 只读	返回指定矩形左边界的坐标。
Right	int, 只读	返回指定矩形右边界的坐标。
Top	int, 只读	返回指定矩形上边界的坐标。

方法

名称	描述
AddRect	向Region添加一个Rectangle区域。
AddRegion	向现有Region添加一个新区域。
CopyFrom	用另一个对象中对应属性的值初始化当前对象的属性。
CutRect	从Region中剪切出一个Rectangle区域。
HasIntersectionWithRect	判断该Region是否与指定的 Rectangle 相交。
HasIntersectionWithRegion	判断该Region是否与指定Region相交。
IsEqual	判断该Region是否与指定Region相等。
IsPointInRegion	判断指定点是否位于该Region内。
IsRectInRegion	判断指定的 Rectangle 是否包含在该Region内。
IsRegionInRegion	判断指定Region是否包含在该Region内。
LoadFromFile	从磁盘文件中还原对象的内容。
LoadFromMemory <Note> 仅限 Windows。 </Note>	从全局内存中还原对象的内容。
MakeEmpty	删除Region中的所有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 相关对象

语言相关对象

Text 相关对象

文档相关对象

批处理器

机制相关对象

Parameter 对象

分类相关对象

许可证相关对象

文档比较对象

其他对象和方法

枚举

Region 对象（IRegion 接口）

属性

方法

输出参数

输入参数

示例

另请参阅

概述

函数

Engine 对象（IEngine 接口）

Engine 加载器

图像相关对象

Layout 相关对象

语言相关对象

Text 相关对象

文档相关对象

批处理器

机制相关对象

Parameter 对象

分类相关对象

许可证相关对象

文档比较对象

其他对象和方法

枚举

​属性

​方法

​相关对象

​输出参数

​输入参数

​示例

​另请参阅

属性

方法

相关对象

输出参数

输入参数

示例

另请参阅