跳转到主要内容
此对象用于访问文本块的特定属性。这些块对应于图像中被识别为带格式文本的区域。通过此对象，还可以访问该块所覆盖图像区域中的已识别文本。ITextBlock 接口派生自 IBlock 接口，并继承其所有属性。 此对象的属性可分为两组：
  • 影响块中文本识别过程的属性，包括 ImageProcessingParams、AnalysisParams 和 RecognizerParams。这些属性使您能够为单个块设置特殊处理参数。
  • 可在分析后、识别前设置，或由程序在识别过程中填充的属性。其中包括 BlockRole 和 BusinessCardFieldType，用于指定块在不同类型文档中的角色。TextOrientation 属性也属于这一组。
  • 识别结果。这一组仅包含 Text 属性，它表示该块的已识别文本。

​
属性

名称

类型

说明

处理设置

AnalysisParams

TextBlockAnalysisParams

用于访问文本块的分析参数。

ImageProcessingParams

ImageProcessingParams

用于访问文本块的图像预处理参数。

RecognizerParams

RecognizerParams

用于访问文本块的识别参数。

文本的角色和方向

BlockRole

BlockRoleEnum

指定文本块在文档逻辑结构中的角色。

默认值为 BR_Unknown。

BusinessCardFieldType

BusinessCardFieldTypeEnum

用于访问文本块在名片中的角色。

调用 IFRPage::SynthesizeBusinessCard 方法时，FineReader Engine 会将名片中具有指定角色的块视为相应类型的字段。如果该块不能视为此类型的字段，则该块的文本不会出现在名片文本中。

默认值为 BCFT_Unknown。

TextOrientation

TextOrientation

指定块中文本的方向。如果在识别前设置此属性，它会影响块中文本的解释方式 (例如按行还是按列) ；否则，它将在识别后包含检测到的方向。

识别结果

Text

Text, 只读

包含文本块的已识别文本。

​
方法

名称说明
CopyFrom使用另一个对象中对应属性的值初始化当前对象的属性。

​
Windows

TextBlock

​
Linux 和 macOS

TextBlockLinuxMac 对象图

​
输出参数

该对象是 Block 对象的 GetAsTextBlock 方法的输出参数。

​
示例

int totalCharsCount = 0;
FREngine.IBlock block;
// 计算文本中的字符数
if (block.Type == FREngine.BlockTypeEnum.BT_Text)
{
 FREngine.ITextBlock textBlock = block.GetAsTextBlock();
 int paragraphsCount = textBlock.Text.Paragraphs.Count;
 for (int iPar = 0; iPar < paragraphsCount; iPar++)
 {
  FREngine.IParagraph par = textBlock.Text.Paragraphs[iPar];
  string text = par.Text;
  totalCharsCount += text.Length;
 }
}
以下代码示例中使用了该对象：

​
另请参阅

Block Layout 和 Block 的使用 Properties 的使用