跳轉到主要內容
此物件可讓您存取文字區塊的特定屬性。這些區塊對應於影像中被識別為帶格式文字的區域。您也可以透過此物件存取此區塊所涵蓋的影像部分中的已辨識文字。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 與 Blocks 使用 屬性