Passer au contenu principal
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.
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.

Propriétés

,read-only

Retourne l’objet Engine.

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.

Vous pouvez modifier cette propriété uniquement si l’objet Text a été reçu via la propriétéITextBlock::Text. Sinon, la propriété est en lecture seule.

,read-only

Donne accès à la collection de paragraphes de l’objet Text. Chaque objet Text, même vide, contient un sous-objet valide de type Paragraphs . Cet objet est une collection d’objetset peut ne contenir aucun élément. L’objet Paragraph représente un paragraphe dans le texte reconnu. C’est via cet objet que le contenu du texte reconnu peut être récupéré.

Stocke l’orientation du texte. Elle est utilisée en interne par ABBYY FineReader Engine lors de l’exportation du texte reconnu.

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éde l’objet ImageProcessingParams. Pour spécifier l’orientation du texte dans un bloc de texte particulier, définissez la propriétéavant la reconnaissance.

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.

Remarques :

  • La propriété retourne un objet constant. Pour modifier l’orientation du texte, vous devez d’abord obtenir un objet TextOrientation intermédiaire à l’aide de la méthode, modifier les paramètres nécessaires, puis affecter l’objet obtenu à la propriété.
  • Vous pouvez modifier cette propriété uniquement si l’objet Text a été reçu via la propriété. Sinon, la propriété est en lecture seule.
  • Un objet TextOrientation dont la propriétéest égale à RT_UnknownRotation ou dont la propriétéest égale à TRT_Unknown ne peut pas être affecté à cette propriété.

Méthodes

NomDescription
AppendEmptyParagraphAjoute un paragraphe vide à la fin du texte actuel.
GetRangeRenvoie une copie d’une portion du texte.
RemoveSupprime une portion du texte actuel.
RemoveAllSupprime tous les paragraphes du texte actuel.
Text Diagramme des objets

Paramètre d’entrée

Cet objet correspond au paramètre d’entrée de la méthode InsertText de l’objet Paragraph.

Exemples

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
}
L’objet est utilisé dans les exemples de code suivants :

Voir aussi

Utilisation de Text Utilisation des propriétés