跳转到主要内容
此对象表示已识别的文本。已识别的文本由一组段落组成,可通过 Paragraphs 属性访问。除此之外,此对象还提供了一些属性,用于访问不同的文本特性,以及一些可对其执行操作的方法,例如垂直拆分、水平拆分、删除范围等。Text 对象既可以独立存在,也可以作为其他对象的子对象存在,而这些对象表示某种 Layout 单元 (如文本块、表格单元格等) 。文本中的位置由“坐标对” (paragraph;symbol) 定义。还有一种所谓的“特殊位置”,其 paragraph=<段落数>,symbol=0。
可通过包含文本的已识别块访问此对象。您还可以通过 PlainText 对象,以一种特殊的“纯文本”格式访问文档或页面中完整的已识别文本。

属性

,read-only

返回 Engine 对象。

指定整段文本的颜色是否已反转。如果识别文本所属的块或表格单元格同样具有反转属性,则此属性设置为 TRUE。可在用户界面中使用该属性,以黑底白字方式显示文本。

仅当 Text 对象通过ITextBlock::Text属性获取时,才可编辑此属性。否则该属性为只读。

,read-only

提供对 Text 对象段落集合的访问。每个 Text 对象,即使是空对象,也包含一个有效的 Paragraphs 类型子对象。该对象是对象的集合,可能不包含任何元素。Paragraph 对象表示识别文本中的一个段落,识别文本的内容即通过此对象获取。

存储文本的方向,供 ABBYY FineReader Engine 在导出识别文本时内部使用。

此属性仅在识别完成后有意义,但已识别文本的方向无法更改。如需在识别前指定页面方向,请使用 ImageProcessingParams 对象的属性。如需指定特定文本块中的文本方向,请在识别前设置属性。

需要设置此属性值的唯一场景是:您希望插入一些需要出现在导出文件中的附加文本。添加该文本后,使用此属性指定其方向,然后在导出文档前调用执行合成的方法。

注意:

  • 该属性返回一个常量对象。如需更改文本方向,你必须先使用方法获取一个中间 TextOrientation 对象,修改所需参数,然后将该对象赋值给此属性。
  • 仅当 Text 对象通过属性获取时,才可编辑此属性。否则该属性为只读。
  • RotationType 属性等于 RT_UnknownRotation 或属性等于 TRT_Unknown 的 TextOrientation 对象不能赋值给此属性。

方法

名称描述
AppendEmptyParagraph在当前文本末尾追加一个空段落。
GetRange返回指定文本范围的副本。
Remove从当前文本中移除指定范围。
RemoveAll从当前文本中移除所有段落。
Text 对象图

输入参数

此对象是 Paragraph 对象的 InsertText 方法的输入参数。

示例

FREngine.IBlock block;
int suspiciousCharsCount = 0;
// 遍历文本块中的段落并获取文本
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;
 // 对文本进行处理
}
该对象可用于以下代码示例:

另请参阅

使用文本 使用属性