> ## 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-Objekt (ITextBlock-Schnittstelle)

> TextBlock-Objekt (ITextBlock-Schnittstelle) in der ABBYY FineReader Engine API — Repräsentiert einen Textblock; stellt Parameter für Bildvorverarbeitung, Analyse und Erkennung pro Block sowie BlockRole, BusinessCardFieldType, TextOrientation und den erkannten Text bereit; abgeleitet von IBlock.

Dieses Objekt bietet Zugriff auf bestimmte Eigenschaften eines Textblocks. Diese Blöcke entsprechen einem Bildbereich, der als formatierter Text erkannt wurde. Über dieses Objekt kann auch auf den erkannten Text des Bildbereichs zugegriffen werden, den der Block umschließt. Die ITextBlock-Schnittstelle leitet sich von der [IBlock](/de/fine-reader/engine/api-reference/layout-related-objects/block)-Schnittstelle ab und erbt alle ihre Eigenschaften.

Die Eigenschaften dieses Objekts können in zwei Gruppen unterteilt werden:

* die Eigenschaften, die den Prozess der Texterkennung im Block beeinflussen. Dazu gehören ImageProcessingParams, AnalysisParams und RecognizerParams. Mit diesen Eigenschaften können Sie spezielle Verarbeitungsparameter für einen einzelnen Block festlegen.
* die Eigenschaften, die entweder nach der Analyse und vor der Erkennung festgelegt oder vom Programm während der Erkennung ausgefüllt werden können. Dazu gehören BlockRole und BusinessCardFieldType, mit denen die Rolle des Blocks in verschiedenen Dokumenttypen angegeben wird. Die Eigenschaft TextOrientation gehört ebenfalls zu dieser Gruppe.
* die Erkennungsergebnisse. Diese Gruppe enthält nur die Eigenschaft Text, die den erkannten Text des Blocks darstellt.

<div id="properties">
  ## Eigenschaften
</div>

<table><thead><tr><th><p><strong>Name</strong></p></th><th><p><strong>Typ</strong></p></th><th><p><strong>Beschreibung</strong></p></th></tr></thead><tbody><tr><td colspan="3"><p><em>Verarbeitungseinstellungen</em></p></td></tr><tr><td><p><a name="analysisparams" /><strong>AnalysisParams</strong></p></td><td><p><strong><a href="/de/fine-reader/engine/api-reference/layout-related-objects/textblockanalysisparams">TextBlockAnalysisParams</a></strong></p></td><td><p>Ermöglicht den Zugriff auf die Analyseparameter des Textblocks.</p></td></tr><tr><td><p><a name="imageprocessingparams" /><strong>ImageProcessingParams</strong></p></td><td><p><strong><a href="/de/fine-reader/engine/api-reference/image-related-objects/imageprocessingparams">ImageProcessingParams</a></strong></p></td><td><p>Ermöglicht den Zugriff auf die Parameter für die Bildvorverarbeitung des Textblocks.</p></td></tr><tr><td><p><a name="recognizerparams" /><strong>RecognizerParams</strong></p></td><td><p><strong><a href="/de/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams">RecognizerParams</a></strong></p></td><td><p>Ermöglicht den Zugriff auf die Erkennungsparameter des Textblocks.</p></td></tr><tr><td colspan="3"><p><em>Die Rolle und Orientierung des Textes</em></p></td></tr><tr><td><p><a name="blockrole" /><strong>BlockRole</strong></p></td><td><p><strong><a href="/de/fine-reader/engine/api-reference/enumerations/blockroleenum">BlockRoleEnum</a></strong></p></td><td><p>Gibt die Rolle des Textblocks in der logischen Struktur eines Dokuments an.</p><p>Standardmäßig ist der Wert BR\_Unknown.</p></td></tr><tr><td><p><a name="businesscardfieldtype" /><strong>BusinessCardFieldType</strong></p></td><td><p><strong><a href="/de/fine-reader/engine/api-reference/enumerations/businesscardfieldtypeenum">BusinessCardFieldTypeEnum</a></strong></p></td><td><p>Ermöglicht den Zugriff auf die Rolle des Textblocks im Kontext einer Visitenkarte.</p><p>Wenn die Methode <strong><a href="/de/fine-reader/engine/api-reference/document-related-objects/frpage/synthesizebusinesscard-method">IFRPage::SynthesizeBusinessCard</a></strong> aufgerufen wird, geht FineReader Engine davon aus, dass ein Block mit der angegebenen Rolle in einer Visitenkarte ein Feld des entsprechenden Typs ist. Kann der Block nicht als Feld dieses Typs betrachtet werden, wird sein Text nicht in den Text der Visitenkarte übernommen.</p><p>Standardmäßig ist der Wert BCFT\_Unknown.</p></td></tr><tr><td><p><a name="textorientation" /><strong>TextOrientation</strong></p></td><td><p><strong><a href="/de/fine-reader/engine/api-reference/text-related-objects/textorientation">TextOrientation</a></strong></p></td><td><p>Gibt die Textorientierung im Block an. Wenn Sie sie vor der Erkennung festlegen, beeinflusst sie die Art und Weise, wie der Text im Block interpretiert wird (z. B. in Zeilen oder Spalten); andernfalls enthält sie nach der Erkennung die erkannte Orientierung.</p></td></tr><tr><td colspan="3"><p><em>Erkennungsergebnisse</em></p></td></tr><tr><td><p><a name="text" /><strong>Text</strong></p></td><td><p><strong><a href="/de/fine-reader/engine/api-reference/text-related-objects/text">Text</a></strong>, <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">nur lesbar</a></p></td><td><p>Enthält den erkannten Text des Textblocks.</p></td></tr></tbody></table>

<div id="methods">
  ## Methoden
</div>

| Name                                                                                                                     | Beschreibung                                                                                                             |
| ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| [CopyFrom](/de/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection/copyfrom-method) | Initialisiert die Eigenschaften des aktuellen Objekts mit den Werten entsprechender Eigenschaften eines anderen Objekts. |

<div id="related-objects">
  ## Zugehörige Objekte
</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" />[](/de/fine-reader/engine/api-reference/layout-related-objects/layout#visualblocks)[](/de/fine-reader/engine/api-reference/layout-related-objects/layout#blocks)[](/de/fine-reader/engine/api-reference/text-related-objects/textorientation)[](/de/fine-reader/engine/api-reference/text-related-objects/text)[](/de/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams)[](/de/fine-reader/engine/api-reference/layout-related-objects/textblockanalysisparams)[](/de/fine-reader/engine/api-reference/image-related-objects/imageprocessingparams)[](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region)[](/de/fine-reader/engine/api-reference/layout-related-objects/block)[](/de/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)[](/de/fine-reader/engine/api-reference/layout-related-objects/layout)

<div id="linux-and-macos">
  ### Linux und 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" />[](/de/fine-reader/engine/api-reference/text-related-objects/textorientation)[](/de/fine-reader/engine/api-reference/text-related-objects/text)[](/de/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams)[](/de/fine-reader/engine/api-reference/layout-related-objects/textblockanalysisparams)[](/de/fine-reader/engine/api-reference/image-related-objects/imageprocessingparams)[](/de/fine-reader/engine/api-reference/supplementary-objects-and-methods/region)[](/de/fine-reader/engine/api-reference/layout-related-objects/block)[](/de/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)[](/de/fine-reader/engine/api-reference/layout-related-objects/layout#blocks)[](/de/fine-reader/engine/api-reference/layout-related-objects/layout)

[Objektdiagramm](/de/fine-reader/engine/api-reference/object-diagram)

<div id="output-parameter">
  ## Ausgabeparameter
</div>

Dieses Objekt ist der Ausgabeparameter der [GetAsTextBlock](/de/fine-reader/engine/api-reference/layout-related-objects/block/getastextblock-method)-Methode des [Block](/de/fine-reader/engine/api-reference/layout-related-objects/block)-Objekts.

<div id="samples">
  ## Beispiele
</div>

<Accordion title="C#-Code">
  ```csharp theme={null}
  int totalCharsCount = 0;
  FREngine.IBlock block;
  // Berechnet die Anzahl der Zeichen in einem Text
  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>

Das Objekt wird in den folgenden Codebeispielen verwendet:

* Linux: [CustomLanguage](/de/fine-reader/engine/guided-tour/samples#customlanguage)
* Windows: [CustomLanguage](/de/fine-reader/engine/guided-tour/samples#customlanguage), [RecognizedTextProcessing](/de/fine-reader/engine/guided-tour/samples#recognizedtextprocessing) sowie in den Demo Tools: [Engine Predefined Processing Profiles](/de/fine-reader/engine/guided-tour/samples#engine_predefined_processing_profiles)

<div id="see-also">
  ## Siehe auch
</div>

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

[Arbeiten mit Layout und Blöcken](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-layout-and-blocks)

[Arbeiten mit Eigenschaften](/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)