> ## 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.

# Arbeiten mit Text

> Arbeiten Sie mit erkanntem Text in ABBYY FineReader Engine — Unicode-Klartext, Sonderzeichen (Zeilenumbruch, Absatzumbruch, bedingter Trennstrich, Objektersetzung) und Textattribute über das Seitenlayout.

Der Text, den ABBYY FineReader Engine verarbeitet, ist Klartext, d. h., er enthält keine Rahmen, Tabellen usw. Alle Zeichen sind Unicode-Zeichen. Klartext kann die folgenden Sonderzeichen enthalten:

* 0x2028 — Symbol für Zeilenumbruch
* 0x2029 — Symbol für Absatzumbruch
* 0xFFFC — Objektersetzungszeichen (kennzeichnet ein in den Text eingebettetes Bild)
* 0x0009 — Tabulator
* 0x005E — Zirkumflex (^), von ABBYY FineReader Engine als Ersatz für nicht erkannte Zeichen verwendet
* 0x00AC — Bedingter Trennstrich

Auf die Attribute und die Formatierung eines Textes kann über die entsprechenden Objekte und Eigenschaften zugegriffen werden. Sie können über das Seitenlayout eines Dokuments (Eigenschaft [IFRPage::Layout](/de/fine-reader/engine/api-reference/document-related-objects/frpage#layout)) auf den erkannten Text zugreifen.

<div id="recognized-text-in-the-layout">
  ## Erkannter Text im Layout
</div>

Nur Text-, Tabellen- und Barcodeblöcke enthalten nach der Erkennung Text. Andere Blöcke enthalten keinen Text. Das Objekt [Text](/de/fine-reader/engine/api-reference/text-related-objects/text) bietet Zugriff auf den erkannten Text von Text- und Tabellenblöcken, während das Objekt [BarcodeText](/de/fine-reader/engine/api-reference/text-related-objects/barcodetext) Zugriff auf den Text eines Barcodeblocks bietet.

Gehen Sie wie folgt vor, um auf den erkannten Text eines Blocks zuzugreifen:

* Für Textblöcke

Verwenden Sie die Eigenschaft [ITextBlock::Text](/de/fine-reader/engine/api-reference/layout-related-objects/textblock#text).

* Für Tabellenblöcke
  1. Rufen Sie die Sammlung der Tabellenzellen über die Eigenschaft [ITableBlock::Cells](/de/fine-reader/engine/api-reference/layout-related-objects/tableblock) ab.
  2. Wählen Sie die gewünschte Zelle aus. Verwenden Sie dazu die Methoden des Objekts [TableCells](/de/fine-reader/engine/api-reference/layout-related-objects/tablecells).
  3. Rufen Sie das Blockobjekt der Zelle ab (die Eigenschaft [ITableCell::Block](/de/fine-reader/engine/api-reference/layout-related-objects/tablecell)).
  4. Vergewissern Sie sich, dass der Block vom Typ [BT\_Text](/de/fine-reader/engine/api-reference/enumerations/blocktypeenum) ist (die Eigenschaft [IBlock::Type](/de/fine-reader/engine/api-reference/layout-related-objects/block#type)), und rufen Sie dann das Objekt [TextBlock](/de/fine-reader/engine/api-reference/layout-related-objects/textblock) mit der Methode [IBlock::GetAsTextBlock](/de/fine-reader/engine/api-reference/layout-related-objects/block/getastextblock-method) ab.
  5. Verwenden Sie die Eigenschaft [ITextBlock::Text](/de/fine-reader/engine/api-reference/layout-related-objects/textblock#text).
* Für Barcodeblöcke

Rufen Sie den Barcode-Text über die Eigenschaft [IBarcodeBlock::BarcodeText](/de/fine-reader/engine/api-reference/layout-related-objects/barcodeblock#barcodetext) oder [IBarcodeBlock::Text](/de/fine-reader/engine/api-reference/layout-related-objects/barcodeblock#text) ab. Die erste gibt das Objekt [BarcodeText](/de/fine-reader/engine/api-reference/text-related-objects/barcodetext) zurück, das eine Sammlung von Zeichen des erkannten Barcodes ist (die Objekte [BarcodeSymbol](/de/fine-reader/engine/api-reference/text-related-objects/barcodesymbol)). Die zweite gibt den Barcode-Text als einzelnen String zurück.

<div id="text-and-paragraphs">
  ## Text und Absätze
</div>

Das [Text](/de/fine-reader/engine/api-reference/text-related-objects/text)-Objekt enthält eine Sammlung von Absätzen. Diese Sammlung ist ein [Paragraphs](/de/fine-reader/engine/api-reference/text-related-objects/paragraphs)-Objekt, auf das über die Eigenschaft Paragraphs des Text-Objekts zugegriffen werden kann. Das Paragraphs-Objekt ist eine Sammlung von [Paragraph](/de/fine-reader/engine/api-reference/text-related-objects/paragraph)-Objekten. Der erkannte Text ist über die Eigenschaft [IParagraph::Text](/de/fine-reader/engine/api-reference/text-related-objects/paragraph#text) zugänglich. Der Text in dieser Eigenschaft ist ein Unicode-String.

Es gibt auch ein [ParagraphParams](/de/fine-reader/engine/api-reference/text-related-objects/paragraphparams)-Objekt, das absatzspezifische Attribute enthält, z. B. Informationen über die Ausrichtung und den Einzug. Auf dieses Objekt kann über die Eigenschaft [IParagraph::ExtendedParams](/de/fine-reader/engine/api-reference/text-related-objects/paragraph#extendedparams) zugegriffen werden.

Die Eigenschaft [IParagraph::Lines](/de/fine-reader/engine/api-reference/text-related-objects/paragraph#lines) bietet Zugriff auf eine Sammlung von Absatzzeilen, die durch das Objekt [ParagraphLines](/de/fine-reader/engine/api-reference/text-related-objects/paragraphlines) dargestellt wird, das wiederum eine Sammlung von [ParagraphLine](/de/fine-reader/engine/api-reference/text-related-objects/paragraphline)-Objekten ist. Letzteres liefert Informationen über die geometrische Position einer einzelnen Absatzzeile und stellt damit die Unterteilung des Textes in Zeilen dar.

Die Eigenschaft [IParagraph::Words](/de/fine-reader/engine/api-reference/text-related-objects/paragraph#words) bietet Zugriff auf eine Sammlung von Wörtern eines Absatzes, die durch das Objekt [Words](/de/fine-reader/engine/api-reference/text-related-objects/words) dargestellt wird, das eine Sammlung von [Word](/de/fine-reader/engine/api-reference/text-related-objects/word)-Objekten ist. Das Word-Objekt bietet Zugriff auf ein einzelnes Wort des Absatzes.

<div id="character-attributes">
  ## Zeichenattribute
</div>

Jedes Zeichen des Textes hat seine eigenen Parameter. Auf sie kann über das Objekt [CharParams](/de/fine-reader/engine/api-reference/text-related-objects/charparams) zugegriffen werden. Das Objekt CharParams verfügt über eine große Anzahl von Zeichenattributen wie geometrische Parameter, Schriftart und Sprache. Das Objekt CharParams enthält das Zeichen selbst in der Eigenschaft SelectedCharacterRecognitionVariant. Siehe unten auch [Klartext](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-text#plaintext) für die empfohlene Methode, um Informationen zu allen Zeichen in einem Dokument abzurufen.

Die Position eines Zeichens im Text wird durch den Index seines Absatzes und seinen eigenen Index in diesem Absatz definiert. Es gibt außerdem eine sogenannte „Sonderposition“ im Text: Der Index des Absatzes entspricht der Gesamtzahl der Absätze, und der Index des Zeichens ist 0. Dies ist die Einfügemarke am Ende des Textes. Einige Methoden des Objekts [Text](/de/fine-reader/engine/api-reference/text-related-objects/text) führen Operationen an der Sonderposition aus, d. h., sie fügen dort ein weiteres Textfragment oder ein Bild ein.

Die Eigenschaft SelectedCharacterRecognitionVariant des Objekts CharParams ermöglicht den Zugriff auf einen erweiterten Satz von Attributen, die für ein einzelnes Zeichen spezifisch sind und durch das Objekt [CharacterRecognitionVariant](/de/fine-reader/engine/api-reference/text-related-objects/characterrecognitionvariant) dargestellt werden. Diese Attribute werden während der Erkennung festgelegt und liefern einige interne, zeichenspezifische Erkennungsinformationen. Insbesondere liefert dieses Objekt genauere Informationen über die Zuverlässigkeit der Zeichenerkennung, die Wahrscheinlichkeit, dass das Zeichen in einer Serifenschrift vorliegt, usw.

<div id="text-editing">
  ## Textbearbeitung
</div>

Sie können versuchen, die Attribute des Objekts [Text](/de/fine-reader/engine/api-reference/text-related-objects/text) zu ändern, sollten dabei jedoch sehr vorsichtig vorgehen, wenn der Text in ein externes Format exportiert werden soll. Die Exportmethoden von ABBYY FineReader Engine setzen voraus, dass der erkannte Text das Ergebnis der Texterkennung ist und dass der Benutzer nur Erkennungsfehler korrigiert und keine weiteren Änderungen vorgenommen hat. Die Objekte der Text-Gruppe verfügen über zahlreiche voneinander abhängige Eigenschaften, und oft erfordert die Änderung einer dieser Eigenschaften auch Änderungen an anderen Eigenschaften. Aus diesem Grund können Änderungen an den Attributen des erkannten Texts manchmal zu unvorhersehbaren Ergebnissen beim Export führen.

<div id="plain-text">
  ## Klartext
</div>

Sie können auch auf den vollständig erkannten Text eines Dokuments oder einer Seite in einem speziellen „Klartext“-Format zugreifen, das durch das Objekt [PlainText](/de/fine-reader/engine/api-reference/text-related-objects/plaintext) repräsentiert wird. Es enthält nur Informationen über die erkannten Zeichen, ihre Erkennungssicherheit und ihre Positionen relativ zum Quellbild. Es kann jedoch nützlich sein, wenn Sie für alle Zeichen in einem großen Dokument auf diese Attribute zugreifen müssen. In FRE for Windows: Verwenden Sie die Methode [GetCharacterData](/de/fine-reader/engine/api-reference/text-related-objects/plaintext/getcharacterdata-method), mit der Sie die Daten für alle Zeichen auf einmal abrufen und in Ihrer Anwendung darüber iterieren können. Die Iteration über alle Textblöcke nimmt deutlich mehr Zeit in Anspruch, insbesondere wenn Ihre Anwendung über DCOM arbeitet.

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

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

[Arbeiten mit Sprachen](/de/fine-reader/engine/guided-tour/advanced-techniques/working-with-languages)

[Einsatz von Voting-Algorithmen](/de/fine-reader/engine/guided-tour/advanced-techniques/using-voting-api)
