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

# Objet Text (interface IText)

> Objet Text (interface IText) dans l’API ABBYY FineReader Engine — représente le texte reconnu comme une collection de paragraphes ; les positions sont définies par des paires de coordonnées (paragraphe; symbole) ; expose IsInverted et TextOrientation.

Cet objet représente le texte reconnu. Le texte reconnu est une collection de paragraphes. L’accès à cette collection s’effectue via la propriété Paragraphs. En outre, cet objet expose des propriétés permettant d’accéder à différents attributs du texte, ainsi que des méthodes permettant d’effectuer des opérations sur celui-ci, telles que la scission verticale et horizontale, la suppression de plages, etc. L’objet Text peut exister soit de manière indépendante, soit comme sous-objet d’un autre objet représentant une unité de mise en page (bloc de texte, cellule de tableau, etc.). Une position dans le texte est définie par la « paire de coordonnées » (paragraphe; symbole). Il existe également ce que l’on appelle la « position spéciale », pour laquelle paragraphe=\<le nombre de paragraphes>, symbole=0.

<Note>
  Cet objet est disponible par l’intermédiaire d’un bloc reconnu contenant du texte. Vous pouvez également accéder à l’intégralité du texte reconnu du document ou de la page dans un format spécial de « texte brut » via l’objet [PlainText](/fr/fine-reader/engine/api-reference/text-related-objects/plaintext).
</Note>

<div id="properties">
  ## Propriétés
</div>

<table>
  <thead>
    <tr>
      <th>
        <p>
          <strong>Nom</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="/fr/fine-reader/engine/api-reference/engine-object-iengine-interface">
              Engine
            </a>
          </strong>

          ,{" "}

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

      <td>
        <p>
          Retourne l'objet <strong>Engine</strong>.
        </p>
      </td>
    </tr>

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

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

      <td>
        <p>
          Indique si les couleurs de l'ensemble du texte sont inversées. Cet attribut
          est défini sur TRUE si le texte reconnu appartient à un bloc ou à une cellule de tableau
          qui possède également l'attribut d'inversion. Il peut être utilisé dans l'interface utilisateur
          pour afficher le texte en police blanche sur fond noir.
        </p>

        <Note>
          Vous pouvez modifier cette propriété uniquement si l'objet Text a été reçu via la propriété{" "}

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

          {" "}

          . Sinon, la propriété est en lecture seule.
        </Note>
      </td>
    </tr>

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

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

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

          ,{" "}

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

      <td>
        <p>
          Donne accès à la collection de paragraphes de l'objet{" "}
          <strong>Text</strong>. Chaque objet <strong>Text</strong>, même
          vide, contient un sous-objet valide de type{" "}
          <strong>Paragraphs </strong>. Cet objet est une collection d'objets{" "}

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

          {" "}

          et peut ne contenir aucun élément. L'objet{" "}
          <strong>Paragraph </strong>représente un paragraphe dans le
          texte reconnu. C'est via cet objet que le contenu du
          texte reconnu peut être récupéré.
        </p>
      </td>
    </tr>

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

          <strong>TextOrientation</strong>
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/api-reference/text-related-objects/textorientation">
              TextOrientation
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Stocke l'orientation du texte. Elle est utilisée en interne par ABBYY
          FineReader Engine lors de l'exportation du texte reconnu.
        </p>

        <p>
          Cette propriété n'est significative qu'après la reconnaissance, mais il n'est pas possible
          de modifier l'orientation d'un texte déjà reconnu.
          Pour spécifier l'orientation de la page avant la reconnaissance, utilisez
          la propriété{" "}

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

          {" "}

          de l'objet <strong>ImageProcessingParams</strong>. Pour
          spécifier l'orientation du texte dans un bloc de texte particulier, définissez la propriété{" "}

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

          {" "}

          avant la reconnaissance.
        </p>

        <p>
          Le seul cas où vous devez définir la valeur de cette propriété
          est lorsque vous souhaitez insérer du texte supplémentaire devant apparaître dans
          le fichier exporté. Après avoir ajouté ce texte, spécifiez son orientation
          à l'aide de cette propriété et appelez une méthode qui effectue
          la synthèse avant d'exporter le document.
        </p>

        <p>Remarques :</p>

        <ul>
          <li>
            La propriété retourne un objet constant. Pour modifier l'orientation du texte,
            vous devez d'abord obtenir un objet{" "}
            <strong>TextOrientation</strong> intermédiaire à l'aide de la méthode{" "}

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

            {" "}

            , modifier les paramètres nécessaires, puis affecter
            l'objet obtenu à la propriété.
          </li>

          <li>
            Vous pouvez modifier cette propriété uniquement si l'objet <strong>Text</strong>
            a été reçu via la propriété{" "}

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

            {" "}

            . Sinon, la propriété est en lecture seule.
          </li>

          <li>
            Un objet <strong>TextOrientation</strong> dont la propriété{" "}

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

            {" "}

            est égale à RT\_UnknownRotation ou dont la propriété{" "}

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

            {" "}

            est égale à TRT\_Unknown ne peut pas être affecté à cette
            propriété.
          </li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

<div id="methods">
  ## Méthodes
</div>

| Nom                                                                                                                | Description                                         |
| ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------- |
| [AppendEmptyParagraph](/fr/fine-reader/engine/api-reference/text-related-objects/text/appendemptyparagraph-method) | Ajoute un paragraphe vide à la fin du texte actuel. |
| [GetRange](/fr/fine-reader/engine/api-reference/text-related-objects/text/getrange-method)                         | Renvoie une copie d’une portion du texte.           |
| [Remove](/fr/fine-reader/engine/api-reference/text-related-objects/text/remove-method)                             | Supprime une portion du texte actuel.               |
| [RemoveAll](/fr/fine-reader/engine/api-reference/text-related-objects/text/removeall-method)                       | Supprime tous les paragraphes du texte actuel.      |

<div id="related-objects">
  ## Objets connexes
</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" />[](/fr/fine-reader/engine/api-reference/layout-related-objects/textblock#text)[](/fr/fine-reader/engine/api-reference/text-related-objects/paragraph)[](/fr/fine-reader/engine/api-reference/text-related-objects/paragraphs)[](/fr/fine-reader/engine/api-reference/text-related-objects/textorientation)[](/fr/fine-reader/engine/api-reference/layout-related-objects/barcodeblock#editabletext)[](/fr/fine-reader/engine/api-reference/layout-related-objects/barcodeblock)[](/fr/fine-reader/engine/api-reference/layout-related-objects/textblock)

[Diagramme des objets](/fr/fine-reader/engine/api-reference/object-diagram)

<div id="input-parameter">
  ## Paramètre d’entrée
</div>

Cet objet correspond au paramètre d’entrée de la méthode [InsertText](/fr/fine-reader/engine/api-reference/text-related-objects/paragraph/inserttext-method) de l’objet [Paragraph](/fr/fine-reader/engine/api-reference/text-related-objects/paragraph).

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

<Accordion title="Code C#">
  ```csharp theme={null}
  FREngine.IBlock block;
  int suspiciousCharsCount = 0;
  // Parcourt les paragraphes d'un bloc de texte et récupère le texte
  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;
   // faire quelque chose avec le texte
  }
  ```
</Accordion>

L'objet est utilisé dans les exemples de code suivants :

* Linux: [CustomLanguage](/fr/fine-reader/engine/guided-tour/samples#customlanguage)
* Windows: [CustomLanguage](/fr/fine-reader/engine/guided-tour/samples#customlanguage), [RecognizedTextProcessing](/fr/fine-reader/engine/guided-tour/samples#recognizedtextprocessing) ; et dans les outils de démonstration : [Profils de traitement prédéfinis d’Engine](/fr/fine-reader/engine/guided-tour/samples#engine_predefined_processing_profiles)

<div id="see-also">
  ## Voir aussi
</div>

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

[Utilisation des propriétés](/fr/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-properties)