Passer au contenu principal
Les composants visuels sont implémentés dans FRE pour Windows.
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 : TextValidator Pour les textes à sens d’écriture vertical :
TextValidator_CJK
Pour démarrer la vérification orthographique, vous devez appeler la méthode Spell ou SpellBlock 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.
  • 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 (pour C++) et la dispinterface DITextValidatorEvents (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. Dans ce cas, tous les événements de Text Validator seront automatiquement transmis aux autres composants connectés au Synchronizer et l’ensemble de l’application fonctionnera de manière synchrone.

Propriétés

,lecture seule

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

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éILanguageDatabase::DictionaryExtensionsPath.

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.

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.

Par défaut, la valeur est FALSE.

Représente une collection de mots à ignorer lors de la vérification orthographique.

, lecture seule

Indique si la vérification orthographique est en cours.

Représente le document associé à Text Validator.

Indique si Text Validator est verrouillé.

Cette propriété est utile dans les situations suivantes :

  • 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
  • votre application reçoit des notifications de certains événements (par exemple, depuis l’objet) et traite les messages Windows provenant des composants visuels dans ces gestionnaires d’événements.

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.

Par défaut, la valeur est FALSE.

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.

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.

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 leFineReader Engine data folder. Il peut être modifié lors de l’initialisation de FineReader Engine (via lefunction, or via themethod). 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.

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.

Indique si Text Validator doit s’arrêter sur les mots composés lors de la vérification orthographique.

Par défaut, la valeur est FALSE.

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.

Par défaut, la valeur est FALSE.

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é StopAtUncertain ne peuvent pas être définies sur FALSE simultanément.

Par défaut, la valeur est TRUE.

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é StopAtNonDictionary ne peuvent pas être définies sur FALSE simultanément.

Par défaut, la valeur est TRUE.

,lecture seule

Représente une collection de mots suggérés pour corriger l’orthographe des mots reconnus avec incertitude lors de la vérification orthographique.

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

Si Text Validator est connecté à Component Synchronizer, utilisez la propriétéIComponentSynchronizer::ProcessingParamspour 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.

,lecture seule

Représente la position d’un caractère ou d’un mot reconnu avec incertitude.

, lecture seule

Retourne le handle de fenêtre de la zone cliente.

Méthodes

NomDescription
EndSpellingArrête la vérification orthographique.
SpellDémarre la vérification orthographique à partir de la position spécifiée.
SpellBlockVérifie l’orthographe dans le bloc spécifié.
UpdateOptionsMet à 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.

Exemples

Ce composant est utilisé dans les exemples de code ci-dessous : VisualComponents.

Voir aussi

ITextValidatorEvents IComponentSynchronizer::TextValidator Création d’une application avec une interface graphique