> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# TextBlock オブジェクト（ITextBlock インターフェイス）

> ABBYY FineReader Engine API の TextBlock オブジェクト（ITextBlock インターフェイス）。テキストブロックを表し、ブロックごとの画像前処理、解析および認識パラメーター、BlockRole、BusinessCardFieldType、TextOrientation、および認識された Text を提供します。IBlock から派生しています。

このオブジェクトでは、テキストブロックの特定のプロパティにアクセスできます。これらのブロックは、書式付きテキストとして認識された画像領域に対応します。このブロックが囲む画像部分の認識されたテキストにも、このオブジェクトを介してアクセスできます。ITextBlock インターフェイスは [IBlock](/ja/fine-reader/engine/api-reference/layout-related-objects/block) インターフェイスから派生しており、そのすべてのプロパティを継承します。

このオブジェクトのプロパティは、2 つのグループに分けられます。

* ブロック内のテキスト認識処理に影響するプロパティです。これには ImageProcessingParams、AnalysisParams、RecognizerParams があります。これらのプロパティを使用すると、単一のブロックに対して特別な処理パラメーターを設定できます。
* 解析後から認識前までの間に設定することも、認識中にプログラムによって設定されることもあるプロパティです。これには、さまざまな種類の文書におけるブロックの役割を指定するために使用される BlockRole と BusinessCardFieldType が含まれます。TextOrientation プロパティもこのグループに属します。
* 認識結果です。このグループに含まれるのは Text プロパティだけで、これはブロックの認識されたテキストを表します。

<div id="properties">
  ## プロパティ
</div>

<table><thead><tr><th><p><strong>名前</strong></p></th><th><p><strong>型</strong></p></th><th><p><strong>説明</strong></p></th></tr></thead><tbody><tr><td colspan="3"><p><em>処理設定</em></p></td></tr><tr><td><p><a name="analysisparams" /><strong>AnalysisParams</strong></p></td><td><p><strong><a href="/ja/fine-reader/engine/api-reference/layout-related-objects/textblockanalysisparams">TextBlockAnalysisParams</a></strong></p></td><td><p>テキストブロックの解析パラメーターにアクセスします。</p></td></tr><tr><td><p><a name="imageprocessingparams" /><strong>ImageProcessingParams</strong></p></td><td><p><strong><a href="/ja/fine-reader/engine/api-reference/image-related-objects/imageprocessingparams">ImageProcessingParams</a></strong></p></td><td><p>テキストブロックの画像前処理パラメーターにアクセスします。</p></td></tr><tr><td><p><a name="recognizerparams" /><strong>RecognizerParams</strong></p></td><td><p><strong><a href="/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams">RecognizerParams</a></strong></p></td><td><p>テキストブロックの認識パラメーターにアクセスします。</p></td></tr><tr><td colspan="3"><p><em>テキストの役割と向き</em></p></td></tr><tr><td><p><a name="blockrole" /><strong>BlockRole</strong></p></td><td><p><strong><a href="/ja/fine-reader/engine/api-reference/enumerations/blockroleenum">BlockRoleEnum</a></strong></p></td><td><p>ドキュメントの論理構造におけるテキストブロックの役割を指定します。</p><p>既定値は BR\_Unknown です。</p></td></tr><tr><td><p><a name="businesscardfieldtype" /><strong>BusinessCardFieldType</strong></p></td><td><p><strong><a href="/ja/fine-reader/engine/api-reference/enumerations/businesscardfieldtypeenum">BusinessCardFieldTypeEnum</a></strong></p></td><td><p>名刺内の要素としてのテキストブロックの役割にアクセスします。</p><p><strong><a href="/ja/fine-reader/engine/api-reference/document-related-objects/frpage/synthesizebusinesscard-method">IFRPage::SynthesizeBusinessCard</a></strong> メソッドが呼び出されると、FineReader Engine は、名刺内で指定された役割を持つブロックを、対応する型の field と見なします。ブロックがこの型の field と見なされない場合、そのブロックのテキストは名刺のテキストに含まれません。</p><p>既定値は BCFT\_Unknown です。</p></td></tr><tr><td><p><a name="textorientation" /><strong>TextOrientation</strong></p></td><td><p><strong><a href="/ja/fine-reader/engine/api-reference/text-related-objects/textorientation">TextOrientation</a></strong></p></td><td><p>ブロック内のテキストの向きを指定します。認識前に設定すると、ブロック内のテキストの解釈方法 (たとえば、行として扱うか列として扱うか) に影響します。設定しない場合は、認識後に検出された向きが格納されます。</p></td></tr><tr><td colspan="3"><p><em>認識結果</em></p></td></tr><tr><td><p><a name="text" /><strong>Text</strong></p></td><td><p><strong><a href="/ja/fine-reader/engine/api-reference/text-related-objects/text">Text</a></strong>, <a href="/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">読み取り専用</a></p></td><td><p>テキストブロックの認識されたテキストが格納されます。</p></td></tr></tbody></table>

<div id="methods">
  ## メソッド
</div>

| 名前                                                                                                                       | 説明                                            |
| ------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------- |
| [CopyFrom](/ja/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method) | 現在のオブジェクトのプロパティを、別のオブジェクトの類似するプロパティの値で初期化します。 |

<div id="related-objects">
  ## 関連オブジェクト
</div>

<div id="windows">
  ### Windows
</div>

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/textblock.gif?s=ca74ed6df756c415d84620c1244dfac0" alt="TextBlock" width="303" height="235" data-path="images/fine-reader/engine/textblock.gif" />[](/ja/fine-reader/engine/api-reference/layout-related-objects/layout#visualblocks)[](/ja/fine-reader/engine/api-reference/layout-related-objects/layout#blocks)[](/ja/fine-reader/engine/api-reference/text-related-objects/textorientation)[](/ja/fine-reader/engine/api-reference/text-related-objects/text)[](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams)[](/ja/fine-reader/engine/api-reference/layout-related-objects/textblockanalysisparams)[](/ja/fine-reader/engine/api-reference/image-related-objects/imageprocessingparams)[](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region)[](/ja/fine-reader/engine/api-reference/layout-related-objects/block)[](/ja/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)[](/ja/fine-reader/engine/api-reference/layout-related-objects/layout)

<div id="linux-and-macos">
  ### Linux および macOS
</div>

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/textblocklinuxmac.gif?s=b97c4325e7fd9b26c3a42e5805d36f44" alt="TextBlockLinuxMac" width="303" height="238" data-path="images/fine-reader/engine/textblocklinuxmac.gif" />[](/ja/fine-reader/engine/api-reference/text-related-objects/textorientation)[](/ja/fine-reader/engine/api-reference/text-related-objects/text)[](/ja/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams)[](/ja/fine-reader/engine/api-reference/layout-related-objects/textblockanalysisparams)[](/ja/fine-reader/engine/api-reference/image-related-objects/imageprocessingparams)[](/ja/fine-reader/engine/api-reference/supplementary-objects-and-methods/region)[](/ja/fine-reader/engine/api-reference/layout-related-objects/block)[](/ja/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)[](/ja/fine-reader/engine/api-reference/layout-related-objects/layout#blocks)[](/ja/fine-reader/engine/api-reference/layout-related-objects/layout)

[オブジェクト図](/ja/fine-reader/engine/api-reference/object-diagram)

<div id="output-parameter">
  ## 出力パラメーター
</div>

このオブジェクトは、[Block](/ja/fine-reader/engine/api-reference/layout-related-objects/block)オブジェクトの[GetAsTextBlock](/ja/fine-reader/engine/api-reference/layout-related-objects/block/getastextblock-method)メソッドの出力パラメーターです。

<div id="samples">
  ## サンプル
</div>

<Accordion title="C# コード">
  ```csharp theme={null}
  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;
   }
  }
  ```
</Accordion>

このオブジェクトは、以下のコード サンプルで使用されています。

* Linux: [CustomLanguage](/ja/fine-reader/engine/guided-tour/samples#customlanguage)
* Windows: [CustomLanguage](/ja/fine-reader/engine/guided-tour/samples#customlanguage), [RecognizedTextProcessing](/ja/fine-reader/engine/guided-tour/samples#recognizedtextprocessing)、およびデモ ツール: [Engine Predefined Processing Profiles](/ja/fine-reader/engine/guided-tour/samples#engine_predefined_processing_profiles)

<div id="see-also">
  ## 関連項目
</div>

[Block](/ja/fine-reader/engine/api-reference/layout-related-objects/block)

[Layout と Block の操作](/ja/fine-reader/engine/guided-tour/advanced-techniques/working-with-layout-and-blocks)

[Properties の操作](/ja/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)