跳轉到主要內容
此物件代表已辨識的文字。已辨識的文字是由多個段落組成的集合,可透過 Paragraphs 屬性存取。此外,此物件也提供可存取各種文字屬性的屬性,以及可對其執行操作的方法,例如垂直與水平分割、移除範圍等。Text 物件可獨立存在,也可作為其他表示版面單元 (例如文字區塊、表格儲存格等) 之物件的子物件。文字中的位置是由「座標對」 (paragraph;symbol) 定義。另有一種所謂的「特殊位置」,其 paragraph=<段落數量>,symbol=0。
可透過含有文字的已辨識區塊存取此物件。您也可以透過 PlainText 物件,以特殊的「純文字」格式存取文件或頁面的完整已辨識文字。

屬性

,唯讀的

回傳 Engine 物件。

指定整段文字的顏色是否已反轉。若識別文字所屬的 Block 或表格儲存格同樣具有反轉屬性,此屬性將設為 TRUE。可在使用者介面中用於以白色字體顯示文字於黑色背景上。

只有當 Text 物件是透過ITextBlock::Text屬性取得時,才能編輯此屬性。否則,該屬性為唯讀的。

,唯讀的

提供對 Text 物件段落集合的存取。每個 Text 物件,即使是空的,也包含一個有效的 Paragraphs 型別子物件。此物件是物件的集合,可能不含任何元素。Paragraph 物件代表識別文字中的一個段落,識別文字的內容即透過此物件取得。

儲存文字的方向,供 ABBYY FineReader Engine 在匯出識別文字時內部使用。

此屬性僅在識別後才有意義,但您無法變更已識別文字的方向。若要在識別前指定頁面方向,請使用 ImageProcessingParams 物件的屬性。若要指定特定文字 Block 中的文字方向,請在識別前設定屬性。

唯一需要設定此屬性值的情況,是當您希望插入必須出現在匯出檔案中的額外文字時。新增該文字後,請使用此屬性指定其方向,並在匯出文件前呼叫執行合成的方法。

注意事項:

  • 此屬性回傳一個常數物件。若要變更文字方向,必須先使用方法取得中間 TextOrientation 物件,修改所需的參數後,再將取得的物件指派給此屬性。
  • 只有當 Text 物件是透過屬性取得時,才能編輯此屬性。否則,該屬性為唯讀的。
  • TextOrientation 物件的屬性等於 RT_UnknownRotation,或屬性等於 TRT_Unknown 時,無法將該物件指派給此屬性。

方法

名稱描述
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;
 // 對文字進行某些處理
}
此物件可在下列程式碼範例中使用:

另請參閱

使用Text 使用屬性