> ## 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 TextValidator (interface ITextValidator)

> Objet TextValidator (interface ITextValidator) dans les composants visuels ABBYY FineReader Engine sous Windows — L’objet TextValidator est un contrôle ActiveX qui vous permet de vérifier les caractères dont la reconnaissance est incertaine dans un...

<Warning>
  Les composants visuels sont implémentés dans FRE pour Windows.
</Warning>

L’objet TextValidator est un contrôle ActiveX qui permet de vérifier les caractères reconnus de façon incertaine dans un document. Le document est relié au composant via la propriété FRDocument.

Le composant Text Validator peut se présenter comme suit :

<img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/textvalidator.gif?s=bead22a36b53fc33dbacbee57e482926" alt="TextValidator" width="560" height="428" data-path="images/fine-reader/engine/textvalidator.gif" />

Pour les textes à sens d’écriture vertical :

<Accordion title="Voir l’illustration">
  <img src="https://mintcdn.com/abbyy/i-EfCQVmseNiPQcp/images/fine-reader/engine/textvalidator_cjk.gif?s=b53541ab9960e40a14f44e569aac2767" alt="TextValidator_CJK" width="559" height="427" data-path="images/fine-reader/engine/textvalidator_cjk.gif" />
</Accordion>

Pour démarrer la vérification orthographique, vous devez appeler la méthode [Spell](/fr/fine-reader/engine/visual-components-reference/textvalidator/spell-method) ou [SpellBlock](/fr/fine-reader/engine/visual-components-reference/textvalidator/spellblock-method) de l’objet TextValidator. Si la vérification orthographique est déjà en cours, vous devez d’abord l’arrêter, sinon les nouveaux appels à ces méthodes seront ignorés.

* Vous pouvez également démarrer la vérification orthographique à l’aide du bouton Check Spelling dans [Text Editor](/fr/fine-reader/engine/visual-components-reference/texteditor).
* Certains caractères d’écritures complexes (par exemple le chinois, le thaï ou l’arménien) peuvent ne pas s’afficher dans Text Validator si la police utilisée par Text Validator ne contient pas les caractères correspondants. Dans ce cas, vous pouvez spécifier une autre police dans la boîte de dialogue Options (dans Text Validator, cliquez sur Settings > Options, accédez à l’onglet View et sélectionnez la police dans la liste déroulante Font used to display plain text).

Les informations relatives à la vérification orthographique sont transmises via des interfaces sortantes spéciales. Ces interfaces sont [ITextValidatorEvents](/fr/fine-reader/engine/visual-components-reference/itextvalidatorevents) (pour C++) et la dispinterface [DITextValidatorEvents](/fr/fine-reader/engine/visual-components-reference/itextvalidatorevents) (pour Visual Basic).

Il convient de noter que les utilisateurs de Visual Basic n’ont pas à se soucier des détails d’implémentation des interfaces d’événements, car cette plateforme de développement fournit des moyens simples de les gérer. Cet objet peut être déclaré avec WithEvents dans Visual Basic.

Pour l’utilisateur C++, cela signifie qu’il prend en charge l’interface IConnectionPointContainer. Pour recevoir des notifications d’événements, un utilisateur C++ doit créer un objet dérivé de l’interface ITextValidatorEvents, puis établir la connexion entre celui-ci et la source d’événements implémentée dans l’objet TextValidator à l’aide des mécanismes COM standard.

Le composant Text Validator peut être connecté au composant [Component Synchronizer](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer). Dans ce cas, tous les événements de TextValidator seront automatiquement transmis aux autres composants connectés au Synchronizer et l’ensemble de l’application fonctionnera de manière synchrone.

<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>AddedWords</strong>

          <a name="addedwords" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection">
              SpellWordCollection
            </a>
          </strong>

          ,{" "}

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

      <td>
        <p>
          Représente une collection de mots ajoutés à un dictionnaire par un
          utilisateur lors de la vérification orthographique.
        </p>

        <Note>
          Si des mots sont ajoutés à un dictionnaire lors de la vérification orthographique, le
          dictionnaire utilisateur est créé dans le dossier spécifié par la propriété{" "}

          <a href="/fr/fine-reader/engine/api-reference/language-related-objects/languagedatabase#dictionaryextensionspath">
            ILanguageDatabase::DictionaryExtensionsPath
          </a>

          {" "}

          .
        </Note>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>AutoReplacedWords</strong>

          <a name="autoreplacedwords" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellreplacementcollection">
              SpellReplacementCollection
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Représente une collection de paires de mots. Le premier mot de la paire est
          le mot source automatiquement remplacé lors de la vérification orthographique ;
          le second est le remplacement.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>CorrectSpaces</strong>

          <a name="correctspaces" />
        </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 Text Validator doit corriger les espaces lors de la vérification
          orthographique. Si vous définissez la valeur de cette propriété sur TRUE, Text
          Validator corrigera les espaces avant ou après les signes de ponctuation.
        </p>

        <p>Par défaut, la valeur est FALSE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>IgnoredWords</strong>

          <a name="ignoredwords" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection">
              SpellWordCollection
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Représente une collection de mots à ignorer lors de la
          vérification orthographique.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>IsSpellingInProgress</strong>

          <a name="isspellinginprogress" />
        </p>
      </td>

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

          , lecture seule
        </p>
      </td>

      <td>
        <p>Indique si la vérification orthographique est en cours.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>FRDocument</strong>

          <a name="frdocument" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/api-reference/document-related-objects/frdocument">
              FRDocument
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>Représente le document associé à Text Validator.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>Locked</strong>

          <a name="locked" />
        </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 Text Validator est verrouillé.</p>
        <p>Cette propriété est utile dans les situations suivantes :</p>

        <ul>
          <li>
            une opération d'analyse, de reconnaissance, de synthèse ou d'exportation est appelée depuis
            l'API FineReader Engine (et non depuis les composants visuels), ou
          </li>

          <li>
            votre application reçoit des notifications de certains événements (par exemple,
            depuis l'objet

            <strong>
              {" "}

              <a href="/fr/fine-reader/engine/api-reference/document-related-objects/frdocument">
                FRDocument
              </a>

              {" "}
            </strong>

            ) et traite les messages Windows provenant des composants visuels dans
            ces gestionnaires d'événements.
          </li>
        </ul>

        <p>
          Dans ce cas, nous recommandons de définir cette propriété sur TRUE avant
          l'analyse, la reconnaissance, la synthèse ou l'exportation, et de la remettre à FALSE une fois
          l'opération terminée. Ainsi, le document ne peut pas être altéré
          depuis Text Validator.
        </p>

        <p>Par défaut, la valeur est FALSE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>ReplacedWords</strong>

          <a name="replacedwords" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellreplacementcollection">
              SpellReplacementCollection
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Représente une collection de paires de mots. Le premier mot de la paire est
          le mot source remplacé lors de la vérification orthographique ; le second
          est le remplacement.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>SettingsPath</strong>
        </p>
      </td>

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

      <td>
        <p>
          Spécifie le chemin vers le dossier contenant les fichiers de
          paramètres de Text Validator. Les autres composants visuels disposent de la même
          propriété. Chaque composant visuel doit utiliser son propre dossier de
          paramètres.
        </p>

        <p>
          La valeur de cette propriété est construite à partir du chemin vers le dossier
          dans lequel ABBYY FineReader Engine stocke les données propres à l'utilisateur, et du
          nom de son sous-dossier. Par défaut, le dossier contenant les données propres à l'utilisateur
          est le{" "}

          <a href="/fr/fine-reader/engine/distribution/distribution-windows/distribution-kit#finereader_engine_data_folder">
            FineReader Engine data folder
          </a>

          . Il peut être modifié lors de l'initialisation de FineReader Engine (via
          le{" "}

          <strong>
            <a href="/fr/fine-reader/engine/api-reference/functions/initializeengine-function">
              InitializeEngine
            </a>
          </strong>

          {" "}

          function, or via the{" "}

          <strong>
            <a href="/fr/fine-reader/engine/api-reference/engine-loaders/iengineloader/initializeengine-method">
              IEngineLoader::InitializeEngine
            </a>
          </strong>

          {" "}

          method). Le nom par défaut du sous-dossier est un GUID arbitraire. Pour
          modifier le nom du sous-dossier, spécifiez le nouveau nom dans
          les propriétés du composant dans Visual Studio au moment de la conception. Si
          vous tentez de spécifier la valeur de la propriété au moment de l'exécution, cette valeur
          est ignorée.
        </p>

        <p>
          Si vous ajoutez le composant à un formulaire dans Visual Studio lors de la conception,
          la valeur de la propriété est définie soit automatiquement avec la
          valeur par défaut, soit manuellement avec une valeur personnalisée. Dans les deux cas, la
          valeur est définie au moment de la conception. Si, pour une raison quelconque, la valeur de la
          propriété n'est pas définie au moment de la conception (par exemple, si vous générez le
          composant dynamiquement au moment de l'exécution), le composant crée un nouveau dossier
          contenant les paramètres à chaque initialisation. Pour éviter la
          multiplication des dossiers, supprimez le dossier de paramètres créé
          après la désinitialisation du composant. Dans ce cas, seuls les paramètres par défaut
          du composant sont disponibles et les paramètres ne peuvent pas être enregistrés
          entre les sessions.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>StopAtCompound</strong>

          <a name="stopatcompound" />
        </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 Text Validator doit s'arrêter sur les mots composés lors de la
          vérification orthographique.
        </p>

        <p>Par défaut, la valeur est FALSE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>StopAtGarbage</strong>

          <a name="stopatgarbage" />
        </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 Text Validator doit s'arrêter sur les caractères indésirables lors de la
          vérification orthographique. Les caractères indésirables sont des combinaisons de caractères dénuées de sens.
        </p>

        <p>Par défaut, la valeur est FALSE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>StopAtNonDictionary</strong>

          <a name="stopatnondictionary" />
        </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 Text Validator doit s'arrêter sur les mots absents
          du dictionnaire lors de la vérification orthographique. Cette propriété et la propriété{" "}
          <strong>StopAtUncertain </strong>ne peuvent pas être définies sur FALSE
          simultanément.
        </p>

        <p>Par défaut, la valeur est TRUE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>StopAtUncertain</strong>

          <a name="stopatuncertain" />
        </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 Text Validator doit s'arrêter sur les caractères reconnus avec
          incertitude lors de la vérification orthographique. Cette propriété et la propriété{" "}
          <strong>StopAtNonDictionary </strong>ne peuvent pas être définies sur FALSE
          simultanément.
        </p>

        <p>Par défaut, la valeur est TRUE.</p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>SuggestedWords</strong>

          <a name="suggestedwords" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/visual-components-reference/supplementary-objects/spellwordcollection">
              SpellWordCollection
            </a>
          </strong>

          ,{" "}

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

      <td>
        <p>
          Représente une collection de mots suggérés pour corriger
          l'orthographe des mots reconnus avec incertitude lors de la vérification orthographique.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>SynthesisParamsForDocument</strong>

          <a name="synthesisparamsfordocument" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/synthesisparamsfordocument">
              SynthesisParamsForDocument
            </a>
          </strong>
        </p>
      </td>

      <td>
        <p>
          Spécifie les paramètres de synthèse par défaut pour un document. Ces
          paramètres sont utilisés lorsque Text Validator doit effectuer la synthèse du document
          (ce qui peut se produire si la structure logique d'un document
          devient incorrecte suite à certaines opérations d'édition).
        </p>

        <Note>
          Si Text Validator est connecté à Component Synchronizer, utilisez la propriété{" "}

          <a href="/fr/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer#processingparams">
            IComponentSynchronizer::ProcessingParams
          </a>

          {" "}

          pour modifier les paramètres utilisés pour la synthèse du document. La modification
          de ces paramètres via la propriété de Text Validator peut provoquer des erreurs.
        </Note>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>ValidatorError</strong>

          <a name="validatorerror" />
        </p>
      </td>

      <td>
        <p>
          <strong>
            <a href="/fr/fine-reader/engine/visual-components-reference/supplementary-objects/validatorerror">
              ValidatorError
            </a>
          </strong>

          ,{" "}

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

      <td>
        <p>
          Représente la position d'un caractère ou d'un mot reconnu avec incertitude.
        </p>
      </td>
    </tr>

    <tr>
      <td>
        <p>
          <strong>WindowHandle</strong>

          <a name="windowhandle" />
        </p>
      </td>

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

          , lecture seule
        </p>
      </td>

      <td>
        <p>Retourne le handle de fenêtre de la zone cliente.</p>
      </td>
    </tr>
  </tbody>
</table>

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

| Nom                                                                                                    | Description                                                                                                                                                                                                                     |
| ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [EndSpelling](/fr/fine-reader/engine/visual-components-reference/textvalidator/endspelling-method)     | Arrête la vérification orthographique.                                                                                                                                                                                          |
| [Spell](/fr/fine-reader/engine/visual-components-reference/textvalidator/spell-method)                 | Démarre la vérification orthographique à partir de la position spécifiée.                                                                                                                                                       |
| [SpellBlock](/fr/fine-reader/engine/visual-components-reference/textvalidator/spellblock-method)       | Vérifie l’orthographe dans le bloc spécifié.                                                                                                                                                                                    |
| [UpdateOptions](/fr/fine-reader/engine/visual-components-reference/textvalidator/updateoptions-method) | Met à jour les paramètres définis dans la boîte de dialogue Options de Text Validator. Il peut être nécessaire d’appeler cette méthode si les options ont été modifiées dans un autre Visual Component, afin de les actualiser. |

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

Ce composant est utilisé dans les exemples de code ci-dessous : [VisualComponents](/fr/fine-reader/engine/guided-tour/samples#visualcomponents).

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

[ITextValidatorEvents](/fr/fine-reader/engine/visual-components-reference/itextvalidatorevents)

[IComponentSynchronizer::TextValidator](/fr/fine-reader/engine/visual-components-reference/supplementary-objects/componentsynchronizer#textvalidator)

[Création d’une application avec une interface graphique](/fr/fine-reader/engine/guided-tour/advanced-techniques/using-gui-elements/creating-an-application-with-gui)