Saltar al contenido principal
Los componentes visuales están implementados en FRE para Windows.
El objeto TextValidator es un control ActiveX que le permite verificar caracteres reconocidos de forma incierta en un documento. El documento se conecta al componente mediante la propiedad FRDocument. El componente Text Validator puede tener este aspecto: TextValidator Para textos con dirección de escritura vertical:
TextValidator_CJK
Para iniciar la revisión ortográfica, debe llamar al método Spell o SpellBlock del objeto TextValidator. Si la revisión ortográfica ya está en curso, primero debe detenerla; de lo contrario, las nuevas llamadas a estos métodos se ignorarán.
  • También puede iniciar la revisión ortográfica con el botón Check Spelling del Editor de texto.
  • Es posible que algunos caracteres de idiomas con escrituras complejas (por ejemplo, chino, tailandés o armenio) no se muestren en Text Validator si la fuente utilizada en Text Validator no incluye los caracteres correspondientes. En este caso, puede especificar otra fuente en el cuadro de diálogo Options (en Text Validator, haga clic en Settings > Options, vaya a la pestaña View y seleccione la fuente en la lista desplegable Font used to display plain text).
La información sobre la revisión ortográfica se transmite mediante interfaces salientes especiales. Estas interfaces son ITextValidatorEvents (para C++) y la dispinterface DITextValidatorEvents (para Visual Basic). Cabe señalar que los usuarios de Visual Basic no deben preocuparse por los detalles de implementación de las interfaces de eventos, ya que esta plataforma de desarrollo proporciona medios sencillos para controlarlos. Este objeto puede declararse con WithEvents en Visual Basic. Para el usuario de C++, esto significa que admite la interfaz IConnectionPointContainer. Para recibir eventos de notificación, un usuario de C++ debe crear un objeto derivado de la interfaz ITextValidatorEvents y, a continuación, establecer la conexión entre este objeto y el origen de eventos implementado en el objeto TextValidator por medios COM estándar. El componente Text Validator puede conectarse al componente Component Synchronizer; en ese caso, todos los eventos de Text Validator se transmitirán automáticamente a otros componentes conectados al Synchronizer y toda la aplicación funcionará de forma sincrónica.

Propiedades

,de solo lectura

Representa una colección de palabras que el usuario agregó a un diccionario durante la revisión ortográfica.

Si se agregan palabras a un diccionario durante la revisión ortográfica, el diccionario de usuario se crea en la carpeta especificada por la propiedadILanguageDatabase::DictionaryExtensionsPath.

Representa una colección de pares de palabras. La primera palabra del par es la palabra de origen que se reemplaza automáticamente durante la revisión ortográfica; la segunda es el reemplazo.

Especifica si Text Validator debe corregir los espacios durante la revisión ortográfica. Si establece el valor de esta propiedad en TRUE, Text Validator corregirá los espacios antes o después de los signos de puntuación.

De forma predeterminada, el valor es FALSE.

Representa una colección de palabras que deben ignorarse durante la revisión ortográfica.

, de solo lectura

Indica si la revisión ortográfica está en curso.

Representa el documento conectado a Text Validator.

Indica si Text Validator está bloqueado.

Esta propiedad resulta útil en las siguientes situaciones:

  • se llama a una operación de análisis, reconocimiento, síntesis o exportación desde la API de FineReader Engine (no desde Visual Components), o
  • la aplicación recibe notificaciones de determinados eventos (por ejemplo, del objeto) y procesa mensajes de Windows de Visual Components en los controladores de dichos eventos.

En este caso, se recomienda establecer esta propiedad en TRUE antes del análisis, reconocimiento, síntesis o exportación, y en FALSE una vez finalizada la operación. De este modo, el documento no podrá verse afectado desde Text Validator.

De forma predeterminada, el valor es FALSE.

Representa una colección de pares de palabras. La primera palabra del par es la palabra de origen que se reemplaza durante la revisión ortográfica; la segunda es el reemplazo.

Especifica la ruta a la carpeta que contiene los archivos de configuración de Text Validator. Los demás Visual Components tienen la misma propiedad. Cada Visual Component debe usar su propia carpeta de configuración.

El valor de esta propiedad se construye a partir de la ruta a la carpeta en la que ABBYY FineReader Engine almacena los datos específicos del usuario y el nombre de su subcarpeta. De forma predeterminada, la carpeta con datos específicos del usuario es laFineReader Engine data folder. Puede modificarse durante la inicialización de FineReader Engine (mediantefunction, or via themethod). El nombre predeterminado de la subcarpeta es un GUID arbitrario. Para cambiar el nombre de la subcarpeta, especifique el nuevo nombre en las propiedades del componente en Visual Studio en tiempo de diseño. Si intenta especificar el valor de la propiedad en tiempo de ejecución, dicho valor se ignorará.

Si agrega el componente a un formulario en Visual Studio durante el diseño, el valor de la propiedad se define automáticamente con el valor predeterminado o manualmente con un valor personalizado. En ambos casos, el valor se define en tiempo de diseño. Si por algún motivo el valor de la propiedad no se define en tiempo de diseño (por ejemplo, si genera el componente dinámicamente en tiempo de ejecución), el componente crea una nueva carpeta con la configuración cada vez que se inicializa el componente. Para evitar la proliferación de carpetas, elimine la carpeta de configuración creada tras la desinicialización del componente. En este caso, solo podrá usar la configuración predeterminada del componente y no podrá guardar la configuración entre sesiones.

Especifica si Text Validator debe detenerse en palabras compuestas durante la revisión ortográfica.

De forma predeterminada, el valor es FALSE.

Especifica si Text Validator debe detenerse en texto sin sentido durante la revisión ortográfica. El texto sin sentido es una combinación de caracteres que carece de significado.

De forma predeterminada, el valor es FALSE.

Especifica si Text Validator debe detenerse en las palabras que no se encuentran en el diccionario durante la revisión ortográfica. Esta propiedad y la propiedad StopAtUncertain no pueden establecerse en FALSE al mismo tiempo.

De forma predeterminada, el valor es TRUE.

Especifica si Text Validator debe detenerse en los caracteres reconocidos con incertidumbre durante la revisión ortográfica. Esta propiedad y la propiedad StopAtNonDictionary no pueden establecerse en FALSE al mismo tiempo.

De forma predeterminada, el valor es TRUE.

,de solo lectura

Representa una colección de palabras sugeridas para corregir la ortografía de palabras reconocidas con incertidumbre durante la revisión ortográfica.

Especifica los parámetros de síntesis predeterminados para un documento. Estos parámetros se usan cuando Text Validator necesita realizar la síntesis del documento (lo cual puede ocurrir si la estructura lógica del documento queda incorrecta a causa de ciertas operaciones de edición).

Si Text Validator está conectado a Component Synchronizer, use la propiedadIComponentSynchronizer::ProcessingParamspara cambiar los parámetros usados en la síntesis del documento. Si cambia estos parámetros a través de la propiedad de Text Validator, pueden producirse errores.

,de solo lectura

Representa la posición de un carácter o una palabra reconocidos con incertidumbre.

, de solo lectura

Devuelve el identificador de ventana del área de cliente.

Métodos

NombreDescripción
EndSpellingDetiene la revisión ortográfica.
SpellInicia la revisión ortográfica desde la posición especificada.
SpellBlockRevisa la ortografía en el bloque especificado.
UpdateOptionsActualiza la configuración especificada en el cuadro de diálogo Options de Text Validator. Puede que tenga que llamar a este método si las opciones se cambiaron en otro Visual Component para actualizarla al estado actual.

Ejemplos

Este componente se utiliza en los siguientes ejemplos de código: VisualComponents.

Consulte también

ITextValidatorEvents IComponentSynchronizer::TextValidator Creación de una aplicación con interfaz gráfica de usuario