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

# Text-Objekt (IText-Schnittstelle)

> Text-Objekt (IText-Schnittstelle) in der ABBYY FineReader Engine API — Repräsentiert erkannten Text als Sammlung von Absätzen; Positionen werden durch Koordinatenpaare (Absatz; Symbol) definiert; stellt IsInverted und TextOrientation bereit.

Dieses Objekt repräsentiert erkannten Text. Der erkannte Text ist eine Sammlung von Absätzen. Der Zugriff auf diese Sammlung erfolgt über die Eigenschaft Paragraphs. Darüber hinaus stellt dieses Objekt Eigenschaften für den Zugriff auf verschiedene Textattribute sowie Methoden bereit, mit denen sich Operationen wie vertikales und horizontales Aufteilen, das Entfernen von Bereichen usw. ausführen lassen. Das Text-Objekt kann entweder eigenständig vorkommen oder ein Unterobjekt eines anderen Objekts sein, das eine Layouteinheit repräsentiert (Textblock, Tabellenzelle usw.). Eine Position im Text wird durch das „Koordinatenpaar“ (Absatz;Symbol) definiert. Es gibt auch die sogenannte „spezielle Position“, für die paragraph=\<die Anzahl der Absätze>, symbol=0 gilt.

<Note>
  Dieses Objekt ist über einen erkannten Block mit Text verfügbar. Sie können auch über das Objekt [PlainText](/de/fine-reader/engine/api-reference/text-related-objects/plaintext) auf den vollständig erkannten Text des Dokuments oder der Seite in einem speziellen „Nur-Text“-Format zugreifen.
</Note>

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

<table>
  <thead>
    <tr>
      <th>
        <p>
          <strong>Name</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Type</strong>
        </p>
      </th>

      <th>
        <p>
          <strong>Description</strong>
        </p>
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p>
          <strong>Application</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/api-reference/engine-object-iengine-interface">
              Engine
            </a>
          </strong>

          ,{" "}

          <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            read-only
          </a>
        </p>
      </td>

      <td>
        <p>
          Returns the <strong>Engine</strong> object.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>IsInverted</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties">
              VARIANT\_BOOL
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Specifies if the colors of the whole text are inverted. This attribute
          is set to TRUE if the recognized text belongs to a block or table cell
          that also has the inverted attribute. It may be used in user interface
          to display the text with white font against the black background.
        </p>

        <Note>
          You can edit this property only if the Text object was received via
          the{" "}

          <a href="/de/fine-reader/engine/api-reference/layout-related-objects/textblock#text">
            ITextBlock::Text
          </a>

          {" "}

          property. Otherwise, the property is read-only.
        </Note>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <a name="paragraphs" />

          <strong>Paragraphs</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/de/fine-reader/engine/api-reference/text-related-objects/paragraphs">
              Paragraphs
            </a>
          </strong>

          ,{" "}

          <a href="/de/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties#readonly_properties">
            read-only
          </a>
        </p>
      </td>

      <td>
        <p>
          Provides access to the collection of paragraphs of the{" "}
          <strong>Text</strong> object. Every <strong>Text</strong> object, even
          an empty one, contains a valid subobject of the{" "}
          <strong>Paragraphs </strong>type. This object is a collection of the{" "}

          <strong>
            <a href="/de/fine-reader/engine/api-reference/text-related-objects/paragraph">
              Paragraph
            </a>
          </strong>

          {" "}

          objects and may not contain any elements. The{" "}
          <strong>Paragraph </strong>object represents a paragraph in the
          recognized text. It is through this object that the content of the
          recognized text may be obtained.
        </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>
          Stores the orientation of the text. It is used internally by the ABBYY
          FineReader Engine when exporting the recognized text.
        </p>

        <p>
          Diese Eigenschaft ist nur nach der Erkennung aussagekräftig, die Orientierung
          eines bereits erkannten Textes kann jedoch nicht mehr geändert werden.
          Wenn Sie die Seitenorientierung vor der Erkennung festlegen möchten, verwenden Sie
          die{" "}

          <strong>
            <a href="/de/fine-reader/engine/api-reference/image-related-objects/imageprocessingparams#rotationtype">
              RotationType
            </a>
          </strong>

          {" "}

          -Eigenschaft des <strong>ImageProcessingParams</strong>-Objekts. Um
          die Textorientierung in einem bestimmten Textblock festzulegen, setzen Sie die{" "}

          <strong>
            <a href="/de/fine-reader/engine/api-reference/layout-related-objects/textblock#textorientation">
              ITextBlock::TextOrientation
            </a>
          </strong>

          {" "}

          -Eigenschaft vor der Erkennung.
        </p>

        <p>
          The only scenario in which you need to set the value of this property
          is when you wish to insert some additional text which must appear in
          the exported file. After adding that text, specify its orientation
          with the help of this property and call some method which performs
          synthesis before exporting the document.
        </p>

        <p>Notes:</p>

        <ul>
          <li>
            The property returns a constant object. To change the text
            orientation, you must at first obtain an intermediate{" "}
            <strong>TextOrientation</strong> object using the{" "}

            <strong>
              <a href="/de/fine-reader/engine/api-reference/engine-object-iengine-interface/creation-methods/createlessobjectgreater-methods">
                IEngine::CreateTextOrientation
              </a>
            </strong>

            {" "}

            method, change the necessary parameters, and then assign the
            obtained object to the property.
          </li>

          <li>
            You can edit this property only if the <strong>Text</strong> object
            was received via the{" "}

            <strong>
              <a href="/de/fine-reader/engine/api-reference/layout-related-objects/textblock#text">
                ITextBlock::Text
              </a>
            </strong>

            {" "}

            property. Otherwise the property is read-only.
          </li>

          <li>
            The <strong>TextOrientation</strong> object which has{" "}

            <strong>
              <a href="/de/fine-reader/engine/api-reference/text-related-objects/textorientation#rotationtype">
                RotationType
              </a>
            </strong>

            {" "}

            property equal to RT\_UnknownRotation or{" "}

            <strong>
              <a href="/de/fine-reader/engine/api-reference/text-related-objects/textorientation#readingtype">
                ReadingType
              </a>
            </strong>

            {" "}

            property equal to TRT\_Unknown cannot be assigned to this
            property.
          </li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

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

| Name                                                                                                               | Beschreibung                                             |
| ------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------- |
| [AppendEmptyParagraph](/de/fine-reader/engine/api-reference/text-related-objects/text/appendemptyparagraph-method) | Fügt am Ende des aktuellen Texts einen leeren Absatz an. |
| [GetRange](/de/fine-reader/engine/api-reference/text-related-objects/text/getrange-method)                         | Gibt eine Kopie des Textbereichs zurück.                 |
| [Remove](/de/fine-reader/engine/api-reference/text-related-objects/text/remove-method)                             | Entfernt einen Bereich aus dem aktuellen Text.           |
| [RemoveAll](/de/fine-reader/engine/api-reference/text-related-objects/text/removeall-method)                       | Entfernt alle Absätze aus dem aktuellen Text.            |

<div id="related-objects">
  ## Verwandte Objekte
</div>

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/text.gif?s=d5cc47e13de30be27cc4bc41076d5491" alt="Text" width="314" height="160" data-path="images/fine-reader/engine/text.gif" />[](/de/fine-reader/engine/api-reference/layout-related-objects/textblock#text)[](/de/fine-reader/engine/api-reference/text-related-objects/paragraph)[](/de/fine-reader/engine/api-reference/text-related-objects/paragraphs)[](/de/fine-reader/engine/api-reference/text-related-objects/textorientation)[](/de/fine-reader/engine/api-reference/layout-related-objects/barcodeblock#editabletext)[](/de/fine-reader/engine/api-reference/layout-related-objects/barcodeblock)[](/de/fine-reader/engine/api-reference/layout-related-objects/textblock)

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

<div id="input-parameter">
  ## Eingabeparameter
</div>

Dieses Objekt ist der Eingabeparameter der [InsertText](/de/fine-reader/engine/api-reference/text-related-objects/paragraph/inserttext-method)-Methode des [Paragraph](/de/fine-reader/engine/api-reference/text-related-objects/paragraph)-Objekts.

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

<Accordion title="C#-Code">
  ```csharp theme={null}
  FREngine.IBlock block;
  int suspiciousCharsCount = 0;
  // Durchläuft die Absätze eines Textblocks und liest den Text aus
  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;
   // etwas mit dem Text machen
  }
  ```
</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>

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

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