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

# Utilisation du texte

> Utilisez le texte reconnu dans ABBYY FineReader Engine — texte brut Unicode, caractères spéciaux (saut de ligne, saut de paragraphe, trait d’union conditionnel, remplacement d’objet) et attributs du texte via la layout de la page.

Le texte avec lequel ABBYY FineReader Engine fonctionne est du texte brut, c’est-à-dire qu’il ne contient pas de cadres, de tableaux, etc. Tous les caractères sont au format Unicode. Le texte brut peut contenir les caractères spéciaux suivants :

* 0x2028 — Symbole de saut de ligne
* 0x2029 — Symbole de saut de paragraphe
* 0xFFFC — Caractère de remplacement d’objet (indique une image incorporée dans le texte)
* 0x0009 — Tabulation
* 0x005E — Accent circonflexe (^), utilisé par ABBYY FineReader Engine comme caractère de remplacement pour les caractères non reconnus
* 0x00AC — Trait d’union conditionnel

Les attributs et la mise en forme du texte sont accessibles via les objets et propriétés correspondants. Vous pouvez accéder au texte reconnu d’un document via le Layout de sa page (propriété [IFRPage::Layout](/fr/fine-reader/engine/api-reference/document-related-objects/frpage#layout)).

<div id="recognized-text-in-the-layout">
  ## Texte reconnu dans le Layout
</div>

Seuls les blocs de texte, de tableau et de Barcode contiennent du texte après la reconnaissance. Les autres blocs n'en contiennent pas. L'objet [Text](/fr/fine-reader/engine/api-reference/text-related-objects/text) permet d'accéder au texte reconnu des blocs de texte et de tableau, tandis que l'objet [BarcodeText](/fr/fine-reader/engine/api-reference/text-related-objects/barcodetext) permet d'accéder au texte d'un bloc de Barcode.

Pour accéder au texte reconnu d'un bloc, procédez comme suit :

* Pour les blocs de texte

Utilisez la propriété [ITextBlock::Text](/fr/fine-reader/engine/api-reference/layout-related-objects/textblock#text).

* Pour les blocs de tableau
  1. Récupérez la collection des cellules du tableau à l'aide de la propriété [ITableBlock::Cells](/fr/fine-reader/engine/api-reference/layout-related-objects/tableblock).
  2. Sélectionnez la cellule souhaitée. Utilisez les méthodes de l'objet [TableCells](/fr/fine-reader/engine/api-reference/layout-related-objects/tablecells).
  3. Récupérez l'objet bloc de la cellule (la propriété [ITableCell::Block](/fr/fine-reader/engine/api-reference/layout-related-objects/tablecell)).
  4. Vérifiez que le bloc est de type [BT\_Text](/fr/fine-reader/engine/api-reference/enumerations/blocktypeenum) (propriété [IBlock::Type](/fr/fine-reader/engine/api-reference/layout-related-objects/block#type)) et récupérez l'objet [TextBlock](/fr/fine-reader/engine/api-reference/layout-related-objects/textblock) à l'aide de la méthode [IBlock::GetAsTextBlock](/fr/fine-reader/engine/api-reference/layout-related-objects/block/getastextblock-method).
  5. Utilisez la propriété [ITextBlock::Text](/fr/fine-reader/engine/api-reference/layout-related-objects/textblock#text).
* Pour les blocs de Barcode

Récupérez le texte du Barcode à l'aide de la propriété [IBarcodeBlock::BarcodeText](/fr/fine-reader/engine/api-reference/layout-related-objects/barcodeblock#barcodetext) ou [IBarcodeBlock::Text](/fr/fine-reader/engine/api-reference/layout-related-objects/barcodeblock#text). La première renvoie l'objet [BarcodeText](/fr/fine-reader/engine/api-reference/text-related-objects/barcodetext), qui est une collection de caractères du Barcode reconnu (objets [BarcodeSymbol](/fr/fine-reader/engine/api-reference/text-related-objects/barcodesymbol)). La seconde renvoie le texte du Barcode sous la forme d'une seule string.

<div id="text-and-paragraphs">
  ## Text et paragraphes
</div>

L'objet [Text](/fr/fine-reader/engine/api-reference/text-related-objects/text) contient une collection de paragraphes. Cette collection est un objet [Paragraphs](/fr/fine-reader/engine/api-reference/text-related-objects/paragraphs), accessible via la propriété Paragraphs de l'objet Text. L'objet Paragraphs est une collection d'objets [Paragraph](/fr/fine-reader/engine/api-reference/text-related-objects/paragraph). Le texte reconnu est accessible via la propriété [IParagraph::Text](/fr/fine-reader/engine/api-reference/text-related-objects/paragraph#text). Le texte contenu dans cette propriété est une chaîne Unicode.

Il existe également un objet [ParagraphParams](/fr/fine-reader/engine/api-reference/text-related-objects/paragraphparams) qui contient des attributs propres à l'ensemble du paragraphe, tels que des informations sur son alignement et son retrait. Cet objet est accessible via la propriété [IParagraph::ExtendedParams](/fr/fine-reader/engine/api-reference/text-related-objects/paragraph#extendedparams).

La propriété [IParagraph::Lines](/fr/fine-reader/engine/api-reference/text-related-objects/paragraph#lines) donne accès à une collection de lignes de paragraphe représentée par l'objet [ParagraphLines](/fr/fine-reader/engine/api-reference/text-related-objects/paragraphlines), qui est lui-même une collection d'objets [ParagraphLine](/fr/fine-reader/engine/api-reference/text-related-objects/paragraphline). Ce dernier fournit des informations sur la position géométrique d'une ligne de paragraphe et représente donc la division du texte en lignes.

La propriété [IParagraph::Words](/fr/fine-reader/engine/api-reference/text-related-objects/paragraph#words) donne accès à une collection de mots du paragraphe représentée par l'objet [Words](/fr/fine-reader/engine/api-reference/text-related-objects/words), qui est une collection d'objets [Word](/fr/fine-reader/engine/api-reference/text-related-objects/word). L'objet Word donne accès à un mot unique du paragraphe.

<div id="character-attributes">
  ## Attributs des caractères
</div>

Chaque caractère du texte possède ses propres paramètres. Ils sont accessibles via l’objet [CharParams](/fr/fine-reader/engine/api-reference/text-related-objects/charparams). L’objet CharParams comprend un vaste ensemble d’attributs de caractère, tels que ses paramètres géométriques, sa police et sa langue. L’objet CharParams contient également le caractère lui-même dans la propriété SelectedCharacterRecognitionVariant. Voir aussi [Texte brut](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-text#plaintext) ci-dessous pour la méthode recommandée permettant d’obtenir des informations sur tous les caractères d’un document.

La position d’un caractère dans le texte est définie par l’index de son paragraphe et son propre index dans ce paragraphe. Il existe également ce que l’on appelle une « position spéciale » dans le texte : l’index du paragraphe correspond au nombre total de paragraphes, et l’index du caractère est 0. Il s’agit du point d’insertion à la fin du texte. Certaines méthodes de l’objet [Text](/fr/fine-reader/engine/api-reference/text-related-objects/text) effectuent des opérations sur la position spéciale, c’est-à-dire y insèrent un autre fragment de texte ou une image.

La propriété SelectedCharacterRecognitionVariant de l’objet CharParams donne accès à un ensemble étendu d’attributs propres à un caractère donné, représenté par l’objet [CharacterRecognitionVariant](/fr/fine-reader/engine/api-reference/text-related-objects/characterrecognitionvariant). Ces attributs sont définis lors de la reconnaissance et fournissent certaines informations internes sur la reconnaissance propres au caractère. En particulier, cet objet fournit des informations plus précises sur le degré de certitude de la reconnaissance du caractère, sur la probabilité que le caractère appartienne à une police avec empattement, etc.

<div id="text-editing">
  ## Modification du texte
</div>

Vous pouvez essayer de modifier les attributs de l’objet [Text](/fr/fine-reader/engine/api-reference/text-related-objects/text), mais vous devez le faire avec beaucoup de précaution si le texte doit être exporté dans un format externe. Les méthodes d’exportation d’ABBYY FineReader Engine supposent que le texte reconnu est le résultat de la reconnaissance et que l’utilisateur s’est contenté de corriger les erreurs de reconnaissance, sans apporter d’autres modifications. Les objets du groupe Text possèdent de nombreuses propriétés interdépendantes, et la modification de l’une d’elles exige souvent d’en modifier d’autres également. C’est pourquoi les modifications apportées aux attributs du texte reconnu peuvent parfois entraîner des résultats d’exportation imprévisibles.

<div id="plain-text">
  ## Texte brut
</div>

Vous pouvez également accéder à l’intégralité du texte reconnu d’un document ou d’une page dans un format spécial de « texte brut », représenté par l’objet [PlainText](/fr/fine-reader/engine/api-reference/text-related-objects/plaintext). Il fournit uniquement des informations sur les symboles de texte reconnus, leur taux de confiance de reconnaissance et leur position par rapport à l’image source. Cependant, il peut être utile si vous devez accéder à ces attributs pour tous les caractères d’un document volumineux. Dans FRE pour Windows : utilisez sa méthode [GetCharacterData](/fr/fine-reader/engine/api-reference/text-related-objects/plaintext/getcharacterdata-method), qui vous permet d’obtenir en une seule fois les données de tous les caractères et de les parcourir ensuite de votre côté. Parcourir tous les blocs de texte prendra nettement plus de temps, en particulier si votre application fonctionne via DCOM.

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

[Travailler avec Layout et les blocs](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-layout-and-blocks)

[Travailler avec les langues](/fr/fine-reader/engine/guided-tour/advanced-techniques/working-with-languages)

[Utiliser les algorithmes de vote](/fr/fine-reader/engine/guided-tour/advanced-techniques/using-voting-api)